[doc] Some proposals for code organization and style
Merge pull request #108 from abeaumont/master

A proposal for code organization and style