Editing Workflow
How to edit and contribute content to the wiki.
Making Changes
- Create a branch — Use a descriptive name (e.g.,
handbook/add-benefits-guide) - Edit Markdown files — Add or update content in the
docs/folder - Test locally — Run
mkdocs serveand preview your changes - Create a pull request — Include a clear description of what changed and why
- Request review — Assign appropriate reviewers
- Merge to main — Once approved, merge will auto-deploy to the live site
Markdown Tips
- Use clear headings (
#,##,###) - Link to other wiki pages:
[Link text](../path/to/page.md) - Use code blocks for technical content
- Add images to a
docs/assets/folder if needed
Branch Protection
The main branch is protected. All changes require:
- At least one review
- Passing build checks
- Status checks passing
Questions?
See Contributing Index.