ignore .DS_Store
docs cleanup
better param name
added missing param name
fixed documentation
fixed example
added rake task for docs generation