July 2026 - notifications - lists.xwiki.org

[xwiki/xwiki-dev-llm]
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/split-documentation-okf Home: https://github.com/xwiki/xwiki-dev-llm To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0

[xwiki/xwiki-dev-llm] fafcc5: [Misc] Split the oversized documentation OKF file ...
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/master Home: https://github.com/xwiki/xwiki-dev-llm Commit: fafcc56eda2888c8585ec221f860c20ef735d991 https://github.com/xwiki/xwiki-dev-llm/commit/fafcc56eda2888c8585ec221f860c… Author: Vincent Massol <vincent(a)massol.net> 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 A xwiki/okf/conventions/documentation-migration.md M xwiki/okf/conventions/documentation.md M xwiki/okf/index.md M xwiki/skills/xwiki-doc-convert/SKILL.md Log Message: ----------- [Misc] Split the oversized documentation OKF file into authoring and migration parts okf/conventions/documentation.md had grown to 606 lines / 43KB — 5.7x the next largest OKF file and 37% of the whole knowledge base — and both doc skills read it whole, so every authoring task paid for content it never used. * Extract the migration-only rules (handling the original page, deleting its leftover attachments, triaging its backlinks, the e.x.o xproperty prose table) into okf/conventions/documentation-migration.md, referenced by xwiki-doc-convert alone. * Drop the "Documentation Guide — reference index" section, which restated the frontmatter sources; fold the three URLs it uniquely listed into sources:. * Drop the "rules the guide does not state" section — a work list of fixes to propose upstream, not a rule an author applies, and every rule in it is already stated in the body above. documentation.md is now 477 lines / 33.6KB. Co-Authored-By: Claude Opus 5 (1M context) <noreply(a)anthropic.com> Commit: ba453dde6bc1792a8bb367afc60b0b15b0b9d93e https://github.com/xwiki/xwiki-dev-llm/commit/ba453dde6bc1792a8bb367afc60b0… Author: Vincent Massol <vincent(a)massol.net> 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 A xwiki/okf/conventions/documentation-migration.md M xwiki/okf/conventions/documentation.md M xwiki/okf/index.md M xwiki/skills/xwiki-doc-convert/SKILL.md Log Message: ----------- [Misc] Split the oversized documentation OKF file into authoring and migration parts Compare: https://github.com/xwiki/xwiki-dev-llm/compare/9b757b53dcc1...ba453dde6bc1 To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0

[xwiki/xwiki-dev-llm] fafcc5: [Misc] Split the oversized documentation OKF file ...
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/split-documentation-okf Home: https://github.com/xwiki/xwiki-dev-llm Commit: fafcc56eda2888c8585ec221f860c20ef735d991 https://github.com/xwiki/xwiki-dev-llm/commit/fafcc56eda2888c8585ec221f860c… Author: Vincent Massol <vincent(a)massol.net> 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 A xwiki/okf/conventions/documentation-migration.md M xwiki/okf/conventions/documentation.md M xwiki/okf/index.md M xwiki/skills/xwiki-doc-convert/SKILL.md Log Message: ----------- [Misc] Split the oversized documentation OKF file into authoring and migration parts okf/conventions/documentation.md had grown to 606 lines / 43KB — 5.7x the next largest OKF file and 37% of the whole knowledge base — and both doc skills read it whole, so every authoring task paid for content it never used. * Extract the migration-only rules (handling the original page, deleting its leftover attachments, triaging its backlinks, the e.x.o xproperty prose table) into okf/conventions/documentation-migration.md, referenced by xwiki-doc-convert alone. * Drop the "Documentation Guide — reference index" section, which restated the frontmatter sources; fold the three URLs it uniquely listed into sources:. * Drop the "rules the guide does not state" section — a work list of fixes to propose upstream, not a rule an author applies, and every rule in it is already stated in the body above. documentation.md is now 477 lines / 33.6KB. Co-Authored-By: Claude Opus 5 (1M context) <noreply(a)anthropic.com> To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0

[xwiki/xwiki-dev-llm] 4da6f0: [Misc] Split the oversized documentation OKF file ...
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/split-documentation-okf Home: https://github.com/xwiki/xwiki-dev-llm Commit: 4da6f0e26c1150f2434221226f201e667f9ab1c0 https://github.com/xwiki/xwiki-dev-llm/commit/4da6f0e26c1150f2434221226f201… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-07-28 (Tue, 28 Jul 2026) Changed paths: M .claude-plugin/marketplace.json M CLAUDE.md A docs/documentation-guide-upstream-gaps.md M kimi.plugin.json M opencode.jsonc M xwiki/.claude-plugin/plugin.json M xwiki/instructions/xwiki-org.md A xwiki/okf/conventions/documentation-migration.md M xwiki/okf/conventions/documentation.md M xwiki/okf/index.md M xwiki/skills/xwiki-doc-convert/SKILL.md Log Message: ----------- [Misc] Split the oversized documentation OKF file into authoring and migration parts okf/conventions/documentation.md had grown to 606 lines / 43KB — 5.7x the next largest OKF file and 37% of the whole knowledge base — and both doc skills read it whole, so every authoring task paid for content it never used. * Extract the migration-only rules (handling the original page, deleting its leftover attachments, triaging its backlinks, the e.x.o xproperty prose table) into okf/conventions/documentation-migration.md, referenced by xwiki-doc-convert alone. * Drop the "Documentation Guide — reference index" section, which restated the frontmatter sources; fold the three URLs it uniquely listed into sources:. * Move the "rules the guide does not state" work list to docs/documentation-guide-upstream-gaps.md, outside xwiki/ so it no longer ships — every rule in it is already stated in the body above. documentation.md is now 477 lines / 33.6KB. Co-Authored-By: Claude Opus 5 (1M context) <noreply(a)anthropic.com> To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0

[xwiki/xwiki-dev-llm]
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/advisor/015-docguide-sync Home: https://github.com/xwiki/xwiki-dev-llm To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0

[xwiki/xwiki-dev-llm] ffd5a7: [Misc] Sync the doc conventions and doc skills wit...
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/master Home: https://github.com/xwiki/xwiki-dev-llm Commit: ffd5a7cf2a8c5138fac8f3e29800dfaaa85ba486 https://github.com/xwiki/xwiki-dev-llm/commit/ffd5a7cf2a8c5138fac8f3e29800d… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-07-28 (Tue, 28 Jul 2026) Changed paths: M xwiki/okf/conventions/documentation.md M xwiki/skills/xwiki-doc-convert/SKILL.md M xwiki/skills/xwiki-doc-writing/SKILL.md Log Message: ----------- [Misc] Sync the doc conventions and doc skills with the live Documentation Guide Commit: 9b757b53dcc10215ecd78939de5f1a5432c5028e https://github.com/xwiki/xwiki-dev-llm/commit/9b757b53dcc10215ecd78939de5f1… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-07-28 (Tue, 28 Jul 2026) Changed paths: M xwiki/okf/conventions/documentation.md M xwiki/skills/xwiki-doc-convert/SKILL.md M xwiki/skills/xwiki-doc-writing/SKILL.md Log Message: ----------- [Misc] Sync the doc conventions and doc skills with the live Documentation Guide Compare: https://github.com/xwiki/xwiki-dev-llm/compare/e76232b154c9...9b757b53dcc1 To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0

[xwiki/xwiki-dev-llm] ffd5a7: [Misc] Sync the doc conventions and doc skills wit...
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/advisor/015-docguide-sync Home: https://github.com/xwiki/xwiki-dev-llm Commit: ffd5a7cf2a8c5138fac8f3e29800dfaaa85ba486 https://github.com/xwiki/xwiki-dev-llm/commit/ffd5a7cf2a8c5138fac8f3e29800d… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-07-28 (Tue, 28 Jul 2026) Changed paths: M xwiki/okf/conventions/documentation.md M xwiki/skills/xwiki-doc-convert/SKILL.md M xwiki/skills/xwiki-doc-writing/SKILL.md Log Message: ----------- [Misc] Sync the doc conventions and doc skills with the live Documentation Guide To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0

[xwiki/xwiki-dev-llm]
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/okf-doc-image-size-checker-prerelease Home: https://github.com/xwiki/xwiki-dev-llm To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0

[xwiki/xwiki-dev-llm] c0638e: [Misc] Record the mandatory image size, the invisi...
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/master Home: https://github.com/xwiki/xwiki-dev-llm Commit: c0638ef9889fc1bbf55512075eb1d8c4bc72043f https://github.com/xwiki/xwiki-dev-llm/commit/c0638ef9889fc1bbf55512075eb1d… Author: Vincent Massol <vincent(a)massol.net> 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-mechanics.md M xwiki/okf/conventions/documentation.md M xwiki/okf/index.md M xwiki/skills/xwiki-knowledge/SKILL.md Log Message: ----------- [Misc] Record the mandatory image size, the invisible checker findings and pre-release documenting Three facts established while rebuilding the BlockNote user documentation, each one a gap or a contradiction in what the OKF said: - documentation.md presented `size` as optional on the `{{image}}` macro. In the `documentation` space the quality checker requires it and rejects `width`, so a screenshot can never render at its natural width. That moves the constraint onto capture: take it at exactly the pixel width of the size it will be shown at, or it is rescaled — an undersized original is upscaled and blurred. - documentation-mechanics.md said the checker's findings are stored as DocumentationViolationClass objects. Some are not: the image-size one is an inline error box in the rendered page and creates no object at all, so a check that lists objects only reports a broken page as clean. Both surfaces have to be looked at, the second by grepping the rendered HTML for "Best practice:". - The versioning section said to write from the perspective of the latest version, which reads as a ban on documenting anything unreleased. Documenting a feature ahead of its release is accepted and even desirable, so the page is ready on release day, provided the new content carries `{{version since="…"}}`. It also settles the case the rule left open — the newest UI is unreleased and no screenshot can show it: the released version stays the baseline prose and the additions are badged. The xwiki-knowledge skill also told the reader to bump four version fields. There are five: opencode.jsonc carries the version in a comment, and validate.mjs fails the run when it is left behind. Co-Authored-By: Claude Opus 5 (1M context) <noreply(a)anthropic.com> Commit: e76232b154c937cdaceaee871167c4868a2e2c40 https://github.com/xwiki/xwiki-dev-llm/commit/e76232b154c937cdaceaee871167c… Author: Vincent Massol <vincent(a)massol.net> 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-mechanics.md M xwiki/okf/conventions/documentation.md M xwiki/okf/index.md M xwiki/skills/xwiki-knowledge/SKILL.md Log Message: ----------- [Misc] Record the mandatory image size, the invisible checker finding… Compare: https://github.com/xwiki/xwiki-dev-llm/compare/2a2b03f0894c...e76232b154c9 To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0

[xwiki/xwiki-dev-llm] c0638e: [Misc] Record the mandatory image size, the invisi...
by XWiki Notifications 28 Jul '26

28 Jul '26

Branch: refs/heads/okf-doc-image-size-checker-prerelease Home: https://github.com/xwiki/xwiki-dev-llm Commit: c0638ef9889fc1bbf55512075eb1d8c4bc72043f https://github.com/xwiki/xwiki-dev-llm/commit/c0638ef9889fc1bbf55512075eb1d… Author: Vincent Massol <vincent(a)massol.net> 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-mechanics.md M xwiki/okf/conventions/documentation.md M xwiki/okf/index.md M xwiki/skills/xwiki-knowledge/SKILL.md Log Message: ----------- [Misc] Record the mandatory image size, the invisible checker findings and pre-release documenting Three facts established while rebuilding the BlockNote user documentation, each one a gap or a contradiction in what the OKF said: - documentation.md presented `size` as optional on the `{{image}}` macro. In the `documentation` space the quality checker requires it and rejects `width`, so a screenshot can never render at its natural width. That moves the constraint onto capture: take it at exactly the pixel width of the size it will be shown at, or it is rescaled — an undersized original is upscaled and blurred. - documentation-mechanics.md said the checker's findings are stored as DocumentationViolationClass objects. Some are not: the image-size one is an inline error box in the rendered page and creates no object at all, so a check that lists objects only reports a broken page as clean. Both surfaces have to be looked at, the second by grepping the rendered HTML for "Best practice:". - The versioning section said to write from the perspective of the latest version, which reads as a ban on documenting anything unreleased. Documenting a feature ahead of its release is accepted and even desirable, so the page is ready on release day, provided the new content carries `{{version since="…"}}`. It also settles the case the rule left open — the newest UI is unreleased and no screenshot can show it: the released version stays the baseline prose and the additions are badged. The xwiki-knowledge skill also told the reader to bump four version fields. There are five: opencode.jsonc carries the version in a comment, and validate.mjs fails the run when it is left behind. Co-Authored-By: Claude Opus 5 (1M context) <noreply(a)anthropic.com> To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications

1 0