Branch: refs/heads/master Home: https://github.com/xwiki/xwiki-dev-llm Commit: 3b99c44b4dd15b93488e3a03263fcdce1a9e6b56 https://github.com/xwiki/xwiki-dev-llm/commit/3b99c44b4dd15b93488e3a03263fcd... Author: Vincent Massol <[email protected]> Date: 2026-08-14 (Fri, 14 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/skills/xwiki-doc-writing/SKILL.md M xwiki/skills/xwiki-doc-writing/tools/README.md M xwiki/skills/xwiki-doc-writing/tools/docshot.sh Log Message: ----------- [Misc] Capture how a documentation screenshot is framed * okf/conventions/documentation.md: new durable rule next to the screenshot standards. A step's screenshot carries the element to act on plus the nearest landmark that fixes its position (the panel holding it, the screen title above it, the list it follows) and nothing else, the test being whether a reader without the UI in front of them still knows where the action happens. Only a procedure's entry step keeps the surrounding chrome. The `size` follows from the region framed rather than the region being stretched to fill a size, and the existing capture-width bullet now says the width comes from *cropping* a region, not from shrinking a wider capture — which is also why a whole-window shot at `extra` is the blurriest of the options. The red box marks what the step asks for: on a "review the listed accounts" step it belongs around the list, not around the button under it. * skills/xwiki-doc-writing: framing added to the attachment step and as its own review-checklist item, since a page whose every step repeats the same window passes every other check. * skills/xwiki-doc-writing/tools/docshot.sh: takes `x,y,w,h` as the capture target, so a region can be shot at the exact `size` width without resampling; a narrower region is refused rather than upscaled into blur. Two traps documented in tools/README.md, because both fail silently: the CLI has no `--clip` (hence a transparent clip element) and macOS `sips -c` crops from the centre with `--cropOffset` as a no-op, which saves a plausible PNG of the wrong part of the page. A box selector may be prefixed `union:` for one box around several elements, and the box padding is now symmetric — it used to sit flush against the element's right and bottom edges. * Bumped the plugin version to 1.0.27 (patch, content edit) in all five synced fields. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]> Commit: 79d93f793524887ac27a5e7bf6e8046e3fcc7dd3 https://github.com/xwiki/xwiki-dev-llm/commit/79d93f793524887ac27a5e7bf6e804... Author: Vincent Massol <[email protected]> Date: 2026-08-14 (Fri, 14 Aug 2026) Changed paths: M xwiki/skills/xwiki-doc-writing/tools/docshot.sh Log Message: ----------- [Misc] Centre a documentation screenshot's red box on the element it marks * skills/xwiki-doc-writing/tools/docshot.sh: the box geometry was written for `content-box`, but Bootstrap applies `border-box` to every element in XWiki, so the declared width was the outer width and every box came out half a border off-centre: measured on a live page, a 4px gap on the left and top and the border painted 2px *over* the content on the right and bottom, which sliced the text it was meant to mark. `boxSizing` is now set rather than assumed and the width derives from the gap, giving an equal margin on all four sides. * The margin is `GAP` (default 6) and can be overridden per shot, because a target whose own box already carries the clearance needs none: a row of a densely stacked list is a line box whose leading holds the glyphs well inside it, and its neighbours touch it exactly, so adding to it puts the border through the rows above and below. `GAP=0` there. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]> Commit: 017e8b76e310ec2f52c2fed552178644fba987ce https://github.com/xwiki/xwiki-dev-llm/commit/017e8b76e310ec2f52c2fed5521786... Author: Vincent Massol <[email protected]> Date: 2026-08-14 (Fri, 14 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/skills/xwiki-doc-writing/SKILL.md M xwiki/skills/xwiki-doc-writing/tools/README.md M xwiki/skills/xwiki-doc-writing/tools/docshot.sh Log Message: ----------- [Misc] Capture how a documentation screenshot is framed Compare: https://github.com/xwiki/xwiki-dev-llm/compare/6527a0d3d831...017e8b76e310 To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications