Update api.rst
More description. Some grammar and spelling
Merge branch 'patch-5' of https://github.com/slarson/openworm_docs into slarson-patch-3

Conflicts:
	api.rst