Creating Github Markdown pages - BBB Documentation

My newest challenge was to create markdown pages detailing HTML5 Coding Practices and HTML5 Project Structure. Most of the content for the documentation was provided by Daniel Perrone (Really smart guy! Click his name to checkout his Github).

Challenge:

My first challenge was to install Ruby 2.2.4p230 on my existing VM (using VMware). The problem was that certain components of BigBlueButton are dependent on Ruby, and updating Ruby meant uninstalling using:

sudo apt-get purge ruby

(Aside: If you do know how to update to ruby 2.2.4 on ubuntu 14.04 - without uninstalling -, please post a comment below!)

When I ran the command I was prompted to remove the dependent BBB components, which I didn't want to do. Solving this problem was probably the most time consuming of the whole task.

Process:

So after looking for ways to update vs. uninstall (and failing), I decided to create a VM from a backup. This backup had Ubuntu but no BBB.
Sucess!

Once Ruby was installed I used

bundle install

and finally

jekyll serve -H

to have it running on something other than my localhost.

At this point I was able to preview my changes, so all I needed to do was convert the Google Doc to Github Markdown.
First I looked for automatic converters to speed up the process and found 2 that work together:
1. Writage
2. Pandoc

The syntax wasn't quite right, but it did format some things nicely for me like bullets, spaces, and special characters.

Commiting, Pushing and Merging

Once the syntax was ready, I created symbolic links to both new pages, and followed these steps to update it on the official BBB github
1. git add ...
2. git config --global user.email
3. git config --global user.name
4. git commit
5. git push

Now that the changes were pushed to my own fork, it was time to submit a pull request (Compare and Pull Request Button) and finally merge the changes.

And voila! My first commit. What an amazing day!