conventions for documentation

While not hardfast rules, keeping these stylistic conventions in mind makes for easier reading by users

• Start with a documentation template
• Inputs, Outputs, and Consequencesshould not end with periods.