Branch: refs/heads/capture-xwiki-org-rest-and-doc-tooling-learnings Home: https://github.com/xwiki/xwiki-dev-llm Commit: b5d68f9ab6ae56660f970bf7a5b961634f7a6f17 https://github.com/xwiki/xwiki-dev-llm/commit/b5d68f9ab6ae56660f970bf7a5b961... Author: Vincent Massol <[email protected]> Date: 2026-08-28 (Fri, 28 Aug 2026) Changed paths: M .claude-plugin/marketplace.json M kimi.plugin.json M opencode.jsonc M xwiki/.claude-plugin/plugin.json M xwiki/okf/conventions/documentation.md M xwiki/okf/index.md M xwiki/okf/servers/index.md M xwiki/okf/servers/jenkins.md M xwiki/skills/xwiki-doc-writing/SKILL.md M xwiki/skills/xwiki-doc-writing/tools/README.md M xwiki/skills/xwiki-doc-writing/tools/docpages.py M xwiki/skills/xwiki-doc-writing/tools/xwikidoc.py M xwiki/skills/xwiki-rest-api/SKILL.md Log Message: ----------- [Misc] Record the xwiki.org Cloudflare User-Agent block and the doc-tooling traps found while migrating a release-notes doc * okf/servers/index.md: record that www.xwiki.org and extensions.xwiki.org sit behind Cloudflare, which answers 403 to a browser-like User-Agent (and to none at all) on /xwiki/rest — only a curl-style UA passes. The trap was documented for ci.xwiki.org only, so a script written against the doc site hit a 403 that reads as an auth failure. Verified live: browser UA 403, curl UA 200. * okf/servers/jenkins.md: cross-link the two homes of the same Cloudflare trap and cut its section from twelve lines to six — it stated one rule three times. * skills/xwiki-rest-api/SKILL.md: add the same rule as one bullet where the curl commands get written. The skill's /xwiki/rest prefix and nested-space path rules already covered the rest of what the session needed, so nothing was duplicated there. * okf/conventions/documentation.md, skills/xwiki-doc-writing/SKILL.md: the naming checker applies the page-name rules to attachment names too, stop-word removal included — change-in-release-note.png was rejected for change-release-note.png. The OKF said "attachment names follow the page-name rules" without saying the checker enforces it, so the rule read as advisory. * skills/xwiki-doc-writing/tools/docpages.py: lint's "attachment referenced but not declared" check ran on the raw content, so a reference="..." inside a {{code}} block was mistaken for a real attachment reference. Run it on strip_verbatim(content), as the other content checks already do. * skills/xwiki-doc-writing/tools/README.md: never scroll to reach content below the fold — agent-browser screenshot <element> ignores the scroll offset and captures the document region matching the element's viewport rect, silently saving the wrong part of the page. Enlarge the viewport instead. * skills/xwiki-doc-writing/tools/README.md, xwikidoc.py: correct the User-Agent note, which said only that a request with no UA is rejected — a browser UA is rejected too, which is the counter-intuitive half. 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