Publication

I strongly recommend the following suggestions for publishing individual rules and guidelines:

• Use one page per rule or guideline.
• Use standard headings.
• Use short, terse, concise, active-voice sentences.
• Use screenshots generously.
• Use APEX's Websheet tools to author a web-based document in a Wiki format.

Having one rule or guideline per page makes the document modular. This strategy makes it relatively easy to adapt the rules and guidelines to individual projects through a mix-and-match process. Advocates of the Pragmatic Programming methodology will find this approach attractive because it allows teams to quickly pick the rules and guidelines that suit individual projects.

Standard headings provide a template. Templates speed up the writing process by providing a consistent framework and pattern.