Add API docs in hamster/list.rb

These are YARD style docs for the main classes and top-level constructor
methods.
Merge pull request #62 from plexus/api_docs

Add API docs in hamster/list.rb