Archive talk:DocsProject/DocumentationGuide/StyleToDo

It was suggested in the main page that lines should be removed as they were used in the guide. For archival purposes, I'm going to move them - without revision - over to the discussion page as I introduce each concept into the guide.

Don't overuse "most of," "typically," "usually," "many," and such. These water down your instructions and make the tutorial sound wishy-washy, as if you're trying to CYA. A document the length of a typical tutorial can't possibly cover every single case, and shouldn't try.

Don't use "You must do X" when "Do X" will suffice.

Run ispell!

Do not say system functions "should" do something. They do or do not, there is no try. ;-)