Various smaller notes in design document.
update apidoc
fix broken reference in docs
Small coding related TODO document.
Merge pull request #19 from catkin/docs

A few notes in the documentation.