features/modules: Expand modules section
features/modules: clarification & updates

Per Aaron Turon's suggestions, this clarifies much of the wording for
modules.

Additionally, it adds recommendations about:

- Module naming
- Header ordering
- path directives
Merge pull request #5 from nathantypanski/modules

features/modules: Expand modules section