Add API docs in hamster/list.rb

These are YARD style docs for the main classes and top-level constructor
methods.

Cfr #24