✍️ Writing
MkDocs nav.yml and Page Stub from a Locked Page List (No Invented nav Entries)
Draft an MkDocs nav.yml and a matching page stub from a locked page list. No invented nav entries, slugs, or include paths.
0Reviews
Prompt
Act as an MkDocs nav.yml and page-stub editor who only uses a pasted locked page list. You write nav.yml keys and one Markdown stub whose titles and paths the list already names. You do not invent nav entries, extra slugs, or include paths. This is not a Sphinx RST page, not an Antora nav.adoc, and not a DITA map. You work only from Inputs. Do not invent stats, citations, quotes, URLs, names, IDs, or records that are not in Inputs. Inputs: - Page list I lock (titles, paths, section labels I allow): [Pages] - Fact pack I may quote: [Facts] - MkDocs version I lock (or UNKNOWN): [Version] - Theme I lock (or UNKNOWN): [Theme] - Words I must not use: [Banned] - What I must never invent (nav entries, slugs, include paths): [Never] - Output format: [Format] - Language: [Lang] - Max stub paragraphs: [Max] - Audience I may name: [Audience] Generate: 1. Honesty ledger: Pages titles and paths, Facts nouns, Version, Theme, Lang, Max, Audience. Forbidden: invented nav, invented slug, invented include. 2. Path map: each Pages path to KEEP. Paths not in Pages stay leftover OTHER. Do not mint docs/install.md. 3. nav.yml: keys only from Pages. Nested sections only if Pages named them. Theme from Theme or THEME UNKNOWN. 4. Page stub: title from Pages. Paragraphs quote Facts or write NOT IN INPUTS. Stay at or under Max body paragraphs. 5. Refuse list: Sphinx toctree, Antora nav.adoc, DITA map, extra mkdocs.yml plugins not in Inputs. 6. Version: quote Version or write VERSION UNKNOWN. 7. Never: do not add a nav item for a page not in Pages. Do not invent a GitHub Pages URL. 8. Compliance pass: quote Banned and Never hits. Cut them. Count stub paragraphs vs Max. Format as Format. Constraints: - MkDocs nav.yml and stub from Pages and Facts only. Not Sphinx and not Antora. - Never invent nav entries, slugs, or include paths. - Stay at or under Max body paragraphs. - No emojis.
Instructions
Replace every [bracket] with your details before running. Works on ChatGPT, Claude, and Gemini.
Examples
Example Input
Pages: Backup windows -> docs/backup-windows.md; Nightly window -> docs/backup-windows.md#nightly-window as pasted. Restore drill heading allowed as pasted. install.md NOT IN INPUTS. plugins NOT IN INPUTS. Facts: Nightly window starts 02:00 local as pasted. Restore drill is tabletop only. Retention days NOT IN INPUTS. Vendor name NOT IN INPUTS. Version: MkDocs 1.6 UNKNOWN exact pin Theme: UNKNOWN (do not invent material) Banned: best practice, industry standard, always, guaranteed Never: invent nav entries, invent slugs, invent include paths, invent a plugin Format: ledger + path-map + nav.yml + stub + refuse + gaps Lang: English Max: 6 Audience: operators reading a locked page list
Example Output
1. Ledger. Pages: Backup windows docs/backup-windows.md; Nightly window heading allowed; Restore drill heading allowed. install.md NOT IN INPUTS. plugins NOT IN INPUTS. Facts: 02:00 local, tabletop restore. Retention NOT IN INPUTS. Vendor NOT IN INPUTS. Version MkDocs 1.6. pin UNKNOWN. Theme UNKNOWN. Lang English. Max 6. Audience: operators reading a locked page list. Forbidden: invented nav, slug, include, plugin, best practice, industry standard, always, guaranteed. 2. Path map. docs/backup-windows.md KEEP. docs/install.md OTHER leftover (not in Pages). 3. nav.yml sketch. THEME UNKNOWN. VERSION UNKNOWN pin. nav: - Backup windows: backup-windows.md # install.md omitted. NOT IN INPUTS. material theme not invented. 4. Page stub (5 body paragraphs, Max 6). # Backup windows ## Nightly window The nightly window starts 02:00 local as pasted in Facts. Retention days NOT IN INPUTS. Vendor name NOT IN INPUTS. Do not invent a product string. ## Restore drill The restore drill is tabletop only as pasted. No live restore time is in Facts. install.md link refused. Paragraph count 5 vs Max 6. 5. Refuse. Sphinx toctree: refused. Antora nav.adoc: refused. DITA map: refused. docs/install.md nav: refused. material theme: refused. GitHub Pages URL: refused. 6. Version. MkDocs 1.6 as pasted. Exact pin UNKNOWN. 7. Never. No minted install.md. No extra plugin. No include path. 8. Compliance. Banned hits none. Paragraphs 5 vs Max 6. Format ledger+path-map+nav.yml+stub+refuse+gaps. Gaps: retention days, vendor name, theme, plugin list, exact MkDocs pin. Missing-data policy: if a field was blank, write NOT IN INPUTS rather than guessing. Lock any tool version named in Inputs; if unnamed, write unknown. No invented testimonials, star ratings, or press logos. If legal, clinical, insurance, HR, education-plan, or veterinary content appears, add a one-line not-advice and de-identify banner. Quote banned-word hits and cut them. End with a gaps list of five bullets the user still owes you. Character and byte caps in the job are hard; print counts when relevant. Refuse to backfill DOIs, exam dumps, PHI, PII, or compensation promises not in Inputs.