From 522fa996f282f589b458c8562e8fab5069543bb0 Mon Sep 17 00:00:00 2001 From: Rich Braman Date: Tue, 17 Mar 2026 14:38:48 -0400 Subject: [PATCH] Update PUBLISH_GUIDE.md --- PUBLISH_GUIDE.md | 36 +++++++++++++++++++++++------------- 1 file changed, 23 insertions(+), 13 deletions(-) diff --git a/PUBLISH_GUIDE.md b/PUBLISH_GUIDE.md index fdfa07c..d37c212 100644 --- a/PUBLISH_GUIDE.md +++ b/PUBLISH_GUIDE.md @@ -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. ---