Hydrogen: Improve our README structure

[lgeiger]

Our README has a lot of valuable information. Though it's a bit unstructured at the moment. I think we should either move a few sections into separate files or provide a table of content on the top.

For example:
https://github.com/RichardLitt/standard-readme
https://github.com/jakubroztocil/httpie

[willingc]

Here's another good example: https://gist.github.com/PurpleBooth/109311bb0361f32d87a2

[lgeiger]

@willingc Thanks for the link!

[BenRussert]

To start the ball rolling I added a "Contents" header with links to each section to my fork.

I think this small step helps organize a fairly lengthy README.

[willingc]

@BenRussert Looks good and the extra navigation helps.

Two small suggestions:

• Move the GIF up higher under so folks can see it without scrolling. I would grab the sentence about the Medium blog post with the image. So it would flow:
  
  
  
  • Title
  
  
  • badges
  
  
  • The intro sentence "This package lets you run your code ..."
  
  
  • "Checkout our Medium blog post to see what you can do with Hydrogen."
  
  
  • GIF
  
  
  • Contents
  
  
  • Background (less what was moved higher)
  
  

• At the very end of the file, it might be nice to add a "Return to top" link that brings you to the contents or top of file.

Nice job 👍

[BenRussert]

@willingc Great points. I made these changes and opened a pr.