Keep docs short and practical.
docs/tutorials/: learning by doingdocs/how-to/: task stepsdocs/reference/: facts, inputs, outputsdocs/explanation/: rationale and trade-offs
- How-to:
docs/how-to/use-add-issue-to-projects-workflow.mddocs/how-to/use-add-pr-to-projects-workflow.md
- Reference:
docs/reference/reusable-workflows.md
- Explanation:
docs/explanation/README.md
- Put all docs under
docs/. - Pick one category per page.
- Prefer concise examples over long prose.