Clarify guidance for sub-project filenames

Also normalize the documentation file by removing trailing whitespace, adding bold style to notes and other minor changes.