Use ASD-STE100 Simplified Technical English (STE) in documentation. Check all proposed and edited text for STE compliance before you present or save it.
- Use "you" to address the reader when appropriate. Prefer active voice.
- Write procedural steps as complete sentences with periods.
- Use plain text for UI labels in procedures. Do not use bold or italics.
- Use backticks for technical identifiers and values, such as settings.
- Use the
<Screenshot>component for screenshots. - Prefer internal documentation links when a relevant page exists.
- Refer to
docs.moodle.orgas "the Moodle documentation." - If an expandable category links to a content page, show that page as an item in the category. This rule does not apply when the linked page is a category index.
Never try to build the site yourself.