Explain and organize the Gemfile

:fork_and_knife:

Updates the dependencies and explains the known reasons as to why some dependencies are pinned or come from GitHub.

Closes #795.