Update PUBLISH_GUIDE.md

This commit is contained in:
Rich Braman
2026-03-17 14:38:48 -04:00
parent d2996e5e3b
commit 522fa996f2
+23 -13
View File
@@ -145,27 +145,37 @@ or remove the row entirely if the stage doesn't apply.
## mkdocs.yml Nav Entry
Add under the appropriate series tab. Copy this block and update paths/labels:
Add under the appropriate series tab. Use the **structure** below as a
template — replace every `{placeholder}` with the actual session values.
Do NOT copy the example names literally.
**Template (replace all `{placeholders}`):**
```yaml
- "McCullough — Weed Management (2024-03-07)":
- Overview: green-commercial/2024-03-07-mccullough-weed-mgmt/index.md
- Archive Summary: green-commercial/2024-03-07-mccullough-weed-mgmt/archive-summary.md
- Corrections Log: green-commercial/2024-03-07-mccullough-weed-mgmt/corrections.md
- Prose Transcript: green-commercial/2024-03-07-mccullough-weed-mgmt/prose-transcript.md
- Processing Log: green-commercial/2024-03-07-mccullough-weed-mgmt/processing-log.md
- "{Speaker} — {Topic} ({YYYY-MM-DD})":
- Overview: {series}/{session-folder}/index.md
- Archive Summary: {series}/{session-folder}/archive-summary.md
- Corrections Log: {series}/{session-folder}/corrections.md
- Prose Transcript: {series}/{session-folder}/prose-transcript.md
- Processing Log: {series}/{session-folder}/processing-log.md
- Platform Versions:
- YouTube: green-commercial/2024-03-07-mccullough-weed-mgmt/platforms/youtube.md
- Website: green-commercial/2024-03-07-mccullough-weed-mgmt/platforms/website.md
- Extension Agent: green-commercial/2024-03-07-mccullough-weed-mgmt/platforms/ext-agent.md
- YouTube: {series}/{session-folder}/platforms/youtube.md
- Website: {series}/{session-folder}/platforms/website.md
- Extension Agent: {series}/{session-folder}/platforms/ext-agent.md
- Moodle Activities:
- Quiz: green-commercial/2024-03-07-mccullough-weed-mgmt/activities/quiz.md
- Matching: green-commercial/2024-03-07-mccullough-weed-mgmt/activities/matching.md
- Quiz: {series}/{session-folder}/activities/quiz.md
- Matching: {series}/{session-folder}/activities/matching.md
```
Where:
- `{series}` = `green-commercial` or `structural`
- `{session-folder}` = the folder name, e.g. `2024-03-07-mccullough-weed-mgmt`
- `{Speaker}` = last name, `{Topic}` = short title, `{YYYY-MM-DD}` = session date
Nav label format: `"Speaker — Topic (YYYY-MM-DD)"`
Only include lines for files that exist. Place sessions in chronological order
Only include lines for files that actually exist in the session folder.
Place sessions in chronological order
within each series tab.
---