Clarify guidance for sub-project filenames

Also normalize the documentation file by removing trailing whitespace
and adding bold style to notes.
Merge pull request #2315 from fernandoacorreia/subprojects-doc

Clarify guidance for sub-project filenames