API doc notes

Changes on 3/12/14:

• Updated a bunch of .js files to fix formatting. See commit.
• Copied content from markdown files in LoopBack repo into JSDoc comments in this repo:
  • api-datasource.md
  • api-geopoint.md
  • api-model.md
• Reformatted docs.json and moved the following from docs.json:
  • hooks.js
  • types.js

Missing Stuff

Many of the validation functions in validations.js don't have @params.

Other questions

• Why is ModelClass.registerProperty() included in ModelBuilder.js. Should it be part of it's own class API doc?
• Is defineReadonlyProp() a method of DataAccessObject? It doesn't appear to be defined that way? Is it just an internal function that shouldn't be documented?