Contributors: copy the “Body template” section below into a new .md file, replace all {{placeholders}}, then follow Wiki authoring rules and add your page to navigation-by-site-menu.md when it maps to a portal menu area.
Wiki.js Markdown reference (CommonMark + extensions: blockquote colours, dense tables, tabs, task lists, etc.):
Markdown — Wiki.js documentation
Every page should begin with:
---
title: {{Short page title}}
description: {{One line for search / listing.}}
published: true
tags: {{topic-tag}}
editor: markdown
---
Use one line for tags (comma-separated if you need several, e.g. managers, shifts). Do not use a YAML list under tags: — Git import will fail for that file. Use tags: [] if you have no tags yet.
# {{Page title — same as front matter title or slightly longer}}
> **Who should read this**
> {{e.g. Managers with access to Clinical shifts, or All staff}}
> **Where in CrewTech Portal**
> {{Menu path, e.g. Management → Rostering → Clinical shifts}}
> Route: `{{/example/route}}`
---
## Summary
{{2–4 sentences: what the reader will achieve or learn. No jargon unless necessary.}}
---
## Before you start
> {{Optional callout — use Wiki.js blockquote classes after the quote block}}
> {.is-info}
- {{Prerequisite or check, e.g. Confirm your locale badge matches the site you intend to edit.}}
---
## Steps / guidance
### {{Step or section heading}}
{{Clear instructions. Use numbered lists for sequences.}}
### {{Another section}}
| Column A | Column B |
|----------|----------|
| {{row}} | {{row}} |
{.dense}
---
## Related links
| Topic | Link |
|-------|------|
| {{Related topic}} | Replace this cell with a real Markdown link to another wiki page. |
---
## See also
- [How to use this wiki](../how-to-use-this-wiki.md) — where this page sits in the four documentation layers.
- [Find help by site menu](../navigation-by-site-menu.md) — if this page maps to a sidebar area, ensure it is listed there.
---
*Last reviewed: {{YYYY-MM}} — replace when you materially change portal behaviour described here.*
From the Wiki.js Markdown editor guide:
| You want | Pattern |
|---|---|
| Blue callout | Blockquote, then line {.is-info} |
| Green / yellow / red callout | {.is-success} · {.is-warning} · {.is-danger} |
| Compact table | Blank line after table, then {.dense} |
| Tabbed sections (v2.4+) | Parent heading with {.tabset}; child headings one level deeper |
Use one H1 per page (the title), then H2 for major sections and H3 for subsections — consistent hierarchy helps the table of contents in Wiki.js.
Place files under assets/ only. In Markdown use:  (see assets README).
Managers/README.md, Managers/Shifts/README.md, home.md) if the page is a key entry point.