Branch: refs/heads/okf-doc-conventions Home: https://github.com/xwiki/xwiki-dev-llm Commit: 9d29fe55ae84de569e555d34a9496eaeff128f60 https://github.com/xwiki/xwiki-dev-llm/commit/9d29fe55ae84de569e555d34a9496e... Author: Vincent Massol <[email protected]> Date: 2026-08-13 (Thu, 13 Aug 2026) Changed paths: M .claude-plugin/marketplace.json M kimi.plugin.json M opencode.jsonc M xwiki/.claude-plugin/plugin.json M xwiki/instructions/xwiki-org.md M xwiki/okf/conventions/documentation.md M xwiki/okf/index.md M xwiki/skills/xwiki-knowledge/SKILL.md Log Message: ----------- [Misc] Correct the image-caption rule and add four documentation conventions * Fix an actively wrong rule: the guide's WCAG page forbids using `caption` to carry the version a screenshot was taken in, which the OKF recommended. * Add the per-type content rules the guide's Apply Diataxis page states and the OKF lacked: a How-to opens on a link to an Explanation, most of its steps carry a screenshot (and the result step's is mandatory), a topic page is an Explanation linking to its Extensions-wiki page, and several routes to one goal means one How-to per route under a choosing Explanation. * Require the page placement to be settled with the developer up front, as concrete alternative page trees — it is the decision the rules under-determine and the most expensive one to undo. * Add the cross-wiki link trap: the xwiki.org subwikis are one farm, so an absolute URL to extensions.xwiki.org renders as an external link and is never indexed as a backlink. * Add the red-box mechanics: an `outline` is clipped by an ancestor with `overflow: hidden`, so the box must be a body-level overlay, and the saved PNG must be checked for a closed rectangle. * Titles must not repeat the audience, only the page type was covered. * Fix the stale DocGuide/ApplyDiataxis URLs (the page moved under Diataxis/). * Add a "Minimal" gate to the xwiki-knowledge EXTEND checklist: the OKF is read into context, so every added line costs tokens in every session. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]> To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications