major doc overhaul

added coffeedoc-lm to generate api for fields. reworked field comments
to generate (hopefully) decent api.

moved api contents to api/widgets, and added cakefile command `cake docs`
to build field api to api/fields.

fixed some README.md bugs.