Files
pi-dro/.github/instructions/documentation.instructions.md
2026-03-24 20:32:07 +01:00

676 B

applyTo
applyTo
*.md

Project documentation writing guidelines

General Guidelines

  • Write clear and concise documentation.
  • Use consistent terminology and style.
  • Include code examples where applicable.

Grammar

  • Use present tense verbs (is, open) instead of past tense (was, opened).
  • Write factual statements and direct commands. Avoid hypotheticals like "could" or "would".
  • Use active voice where the subject performs the action.
  • Write in second person (you) to speak directly to readers.

Markdown Guidelines

  • Use headings to organize content.
  • Use bullet points for lists.
  • Include links to related resources.
  • Use code blocks for code snippets.