document some of Model's methods
fix typo and style
adds parens
Merge pull request #884 from rmosolgo/rm/model-docs

Docs: Batman.Model