Branch: refs/heads/okf-doc-migration-attachments-dedup Home: https://github.com/xwiki/xwiki-dev-llm Commit: cf1b3745f8017f4f343899dcb52a241f2285a630 https://github.com/xwiki/xwiki-dev-llm/commit/cf1b3745f8017f4f343899dcb52a24... Author: Vincent Massol <[email protected]> Date: 2026-07-28 (Tue, 28 Jul 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-doc-convert/SKILL.md M xwiki/skills/xwiki-doc-writing/SKILL.md Log Message: ----------- [Misc] Capture the attachment, de-duplication and original-page rules for doc migration Four defects found in the JIRA documentation migration traced back to gaps in the OKF rather than to one-off mistakes, so record what was missing: - The guide's "Working with Attachments" page was only listed in the reference index, never summarised. Its rules now have a section of their own — naming, the image macro with alt, the Gallery macro, no animated GIFs, PlantUML with the bluegray theme, and above all that a video is webm displayed with the embed macro and is never downgraded to an attach: link. - "Handling the original page after migration" omitted the guide's requirement to delete the page's remaining attachments, and said only "repoint the backlinks" without saying where the list lives or which entries to leave alone. Both now have their own subsection, including how to prove an attachment is safe to delete. - "One fact lives on one page" was stated but not actionable: it asks the writer to avoid duplication while writing, which does not work because every page reads fine on its own. Replaced by a comparison pass across intros, FAQ entries and hub prose, plus the rule that a How-to's intro is one paragraph. The two doc skills gain the matching steps and checklist items. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]> Commit: 3fccdb5a2a81c8ce166b4c53ddf66c0af0aac4f2 https://github.com/xwiki/xwiki-dev-llm/commit/3fccdb5a2a81c8ce166b4c53ddf66c... Author: Vincent Massol <[email protected]> Date: 2026-07-28 (Tue, 28 Jul 2026) Changed paths: M xwiki/skills/xwiki-rest-api/SKILL.md Log Message: ----------- [Misc] Warn that a misnamed xproperty field blanks the property on a 202 The single-property REST URL expects a `property#<name>` form field. Sending the bare property name is accepted with a 202 and empties the property, so a write that looks successful destroys the previous value on a live page. The read-back assert the skill already mandates is what catches it. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]> Compare: https://github.com/xwiki/xwiki-dev-llm/compare/cf1b3745f801%5E...3fccdb5a2a8... To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications