Discourage procedure syntax, encourage explicit return types.

Also added advice on adding return types to public methods.
Merge pull request #211 from adriaanm/master

Discourage procedure syntax, encourage explicit return types.