Update modeling docs a bit
Merge pull request #3 from cdeil/PR1086_docs_fixes

Update modeling docs a bit