Pudu programming language
Menu
Package

@chrismichaelps / pudu-lang-docgen

Documentation publishing for Pudu: articles, API references, navigation, search, and static websites

0.1.0Apache-2.01

InstallClose

← All tickets

Publish a checked static article docset #2

closed

@chrismichaelps wrote on 2026-09-29

Publish a static article docset from an explicit input snapshot through checked paths, article parsing, navigation, and an original accessible template.

Governing contracts: wiki/architecture/_MOC.md, wiki/architecture/CAPABILITIES.md, wiki/src/PuduLangDocgen.md, wiki/src/PuduLangDocgen/Paths.md. Each additional module must have a complete mirror and resolved Grill Log before code.

Scope: shared records, checked paths/destinations, Markdown article subset with explicit coverage, nested TOC, static shell/search assets, deterministic artifact plan and filesystem publication, example and focused tests. Out of scope: native catalog extraction, richer directives, schema/HTTP importers, PDF and release promotion; tracked separately in the capability ledger.

Acceptance: success/failure/regression/output tests; HTML and attribute escaping; unsafe destinations/traversal/collision/duplicate UID rejection; deterministic search/navigation; no partial-success claims; Pudu check/format/lint/full suite; selected mutation gate; independent API/implementation review and wiki-parity evidence. Split review partitions below 600 changed lines, preserving this issue until the final integration.

Owner: Tooling Engineer; independent reviewers: Language Architect and Forensic Guardian. Risk: new public API, no compiler change. Dependency: #1. Ready design: deterministic artifact planning and confined publication. Handoff: wiki/handoffs/2026-09-29-docgen.md.

Read and reply on GitHub ↗1 comment continue on GitHub.