Branch: refs/heads/vmassol/doc-writing-gaps Home: https://github.com/xwiki/xwiki-dev-llm Commit: 5491293fb33f4debe44f0d17d4da46a2ba26307e https://github.com/xwiki/xwiki-dev-llm/commit/5491293fb33f4debe44f0d17d4da46... Author: Vincent Massol <[email protected]> Date: 2026-10-13 (Tue, 13 Oct 2026) Changed paths: M xwiki/okf/conventions/documentation.md M xwiki/skills/xwiki-doc-writing/SKILL.md M xwiki/skills/xwiki-doc-writing/references/live-examples.md M xwiki/skills/xwiki-doc-writing/references/review-checklist.md M xwiki/skills/xwiki-doc-writing/tools/README.md M xwiki/skills/xwiki-doc-writing/tools/docpages.py Log Message: ----------- [Misc] Doc-writing skill: close the gaps found by the trial run * Tooling applies to every new or rewritten page, a single one included; only a minor fix is made by hand * lint reads a topic page from its path (directly under an audience page), so a one-page set below an existing topic no longer fails as a topic page * Step 12: lint's cross-page checks see only the set, so a lone new page is compared with its siblings by hand * Step 3: a new topic is an Explanation page of its own, proposed together with the How-to that opens it * Step 5: an empty extension-page id is completed on extensions.xwiki.org only on the developer's yes * Checklist: FAQ optional and Related required only for a top-level page's cross-audience links, as the guide's Page Structure says * documentation.md: FAQ optional, empty extension id completed on the extension page, no repetition of a word or a variation of it, title may be more explicit than the name, title case now stated upstream, dead PageTitlesNames link repointed * Live examples replaced with pages that pass the review checklist (result step, intro link to an Explanation, prefixed Technical ID, no pre-LTS version badge) Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]> To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications