September 2026 - notifications

[xwiki/xwiki-dev-llm]
by XWiki Notifications 04 Sep '26

04 Sep '26

Branch: refs/heads/doc-linter-reference-tables 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]
by XWiki Notifications 04 Sep '26

04 Sep '26

Branch: refs/heads/doc-linter-reference-tables 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] 80541f: [Misc] Close the Reference/table blind spot in the...
by XWiki Notifications 04 Sep '26

04 Sep '26

Branch: refs/heads/master Home: https://github.com/xwiki/xwiki-dev-llm Commit: 80541f592d884e1673f4faca65d748956af98e85 https://github.com/xwiki/xwiki-dev-llm/commit/80541f592d884e1673f4faca65d74… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-09-04 (Fri, 04 Sep 2026) Changed paths: 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/docpages.py Log Message: ----------- [Misc] Close the Reference/table blind spot in the doc rules The guide's Reference clause is two-sided — "prefer tables … use code examples for API references" — and the second half reads as licence to drop the first until you notice that a bare signature is a table *column*, not an example: parameters, types, defaults and return value are exactly what a row holds. Nothing caught it, so a seven-member API reference shipped as seven headings each holding one signature, while its sibling written the same week used a table. * The OKF Reference rule now says so explicitly, names the two prose shapes that hide a table (a section per member; a `name: meaning` bullet list) and states the one exemption — every section carrying something no cell can hold, such as a screenshot per option * `docpages.py lint` grows two advisory rules for those two shapes. `{{code}}` deliberately does not exempt the first: a page of bare signatures is the defect, not the cure. Measured over 116 pages / 26 References in 8 harvested trees: 2 hits, both real, no false positive — a Reference with one screenshot per section was the false positive that made the image/diagram exemption necessary * The review checklist grows a "Shows — Reference" item, and says to apply it even to a page whose facts are all correct: the observed miss was a review that pronounced the page "complete and correct" and never asked about its shape * A new authoring step 7 carries the same rule for writing, and `tools/README.md` records both rules with their exemption Co-Authored-By: Claude Opus 5 (1M context) <noreply(a)anthropic.com> Commit: a90de3c48acdc8bae8c232837feb88306992788a https://github.com/xwiki/xwiki-dev-llm/commit/a90de3c48acdc8bae8c232837feb8… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-09-04 (Fri, 04 Sep 2026) Changed paths: 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/docpages.py Log Message: ----------- Merge pull request #112 from xwiki/doc-linter-reference-tables [Misc] Close the Reference/table blind spot in the doc rules Compare: https://github.com/xwiki/xwiki-dev-llm/compare/a243a63f6c04...a90de3c48acd 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] 80541f: [Misc] Close the Reference/table blind spot in the...
by XWiki Notifications 04 Sep '26

04 Sep '26

Branch: refs/heads/doc-linter-reference-tables Home: https://github.com/xwiki/xwiki-dev-llm Commit: 80541f592d884e1673f4faca65d748956af98e85 https://github.com/xwiki/xwiki-dev-llm/commit/80541f592d884e1673f4faca65d74… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-09-04 (Fri, 04 Sep 2026) Changed paths: 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/docpages.py Log Message: ----------- [Misc] Close the Reference/table blind spot in the doc rules The guide's Reference clause is two-sided — "prefer tables … use code examples for API references" — and the second half reads as licence to drop the first until you notice that a bare signature is a table *column*, not an example: parameters, types, defaults and return value are exactly what a row holds. Nothing caught it, so a seven-member API reference shipped as seven headings each holding one signature, while its sibling written the same week used a table. * The OKF Reference rule now says so explicitly, names the two prose shapes that hide a table (a section per member; a `name: meaning` bullet list) and states the one exemption — every section carrying something no cell can hold, such as a screenshot per option * `docpages.py lint` grows two advisory rules for those two shapes. `{{code}}` deliberately does not exempt the first: a page of bare signatures is the defect, not the cure. Measured over 116 pages / 26 References in 8 harvested trees: 2 hits, both real, no false positive — a Reference with one screenshot per section was the false positive that made the image/diagram exemption necessary * The review checklist grows a "Shows — Reference" item, and says to apply it even to a page whose facts are all correct: the observed miss was a review that pronounced the page "complete and correct" and never asked about its shape * A new authoring step 7 carries the same rule for writing, and `tools/README.md` records both rules with their exemption 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 04 Sep '26

04 Sep '26

Branch: refs/tags/v1.5.10 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] a243a6: [Misc] Release 1.5.10
by XWiki Notifications 04 Sep '26

04 Sep '26

Branch: refs/heads/master Home: https://github.com/xwiki/xwiki-dev-llm Commit: a243a63f6c04582147541d2cc03bfc7e5c1df5fe https://github.com/xwiki/xwiki-dev-llm/commit/a243a63f6c04582147541d2cc03bf… Author: github-actions[bot] <41898282+github-actions[bot](a)users.noreply.github.com> Date: 2026-09-04 (Fri, 04 Sep 2026) Changed paths: M .claude-plugin/marketplace.json M kimi.plugin.json M opencode.jsonc M xwiki/.claude-plugin/plugin.json Log Message: ----------- [Misc] Release 1.5.10 * content edits only (no capability added or removed) 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 04 Sep '26

04 Sep '26

Branch: refs/heads/doc-image-alt-attribution 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] 512ba5: [Misc] Name the cause of the dropped image alt text
by XWiki Notifications 04 Sep '26

04 Sep '26

Branch: refs/heads/master Home: https://github.com/xwiki/xwiki-dev-llm Commit: 512ba5c849f4251cdbbf42b2d59e3e21a53e9f48 https://github.com/xwiki/xwiki-dev-llm/commit/512ba5c849f4251cdbbf42b2d59e3… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-09-04 (Fri, 04 Sep 2026) Changed paths: M xwiki/okf/conventions/documentation.md Log Message: ----------- [Misc] Name the cause of the dropped image alt text * PR #110 recorded that xwiki.org renders an image's file name in place of its stored alt, but attributed it to the platform. It is not: on xwiki.org the image macro is DocApp.Code.ImageMacro, a wiki macro of the Documentation Application (org.xwiki.contrib.documentation:documentation-ui, tracked on op.xwiki.org, not JIRA). It declares an alt parameter and then renders the image without it, so the renderer falls back to the file name. Present on master too, and the same application ships an ImageMacroAltCheck that enforces the parameter its own macro discards * The trap now names the macro, which is what makes it actionable: the fix is one line in that XAR, not a platform change Co-Authored-By: Claude Opus 5 (1M context) <noreply(a)anthropic.com> Commit: ed1400a892d02c9a7bf1abc773e8cab57f2b7391 https://github.com/xwiki/xwiki-dev-llm/commit/ed1400a892d02c9a7bf1abc773e8c… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-09-04 (Fri, 04 Sep 2026) Changed paths: M xwiki/okf/conventions/documentation.md Log Message: ----------- Merge pull request #111 from xwiki/doc-image-alt-attribution [Misc] Name the cause of the dropped image alt text Compare: https://github.com/xwiki/xwiki-dev-llm/compare/2ce5e92ac397...ed1400a892d0 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] 512ba5: [Misc] Name the cause of the dropped image alt text
by XWiki Notifications 04 Sep '26

04 Sep '26

Branch: refs/heads/doc-image-alt-attribution Home: https://github.com/xwiki/xwiki-dev-llm Commit: 512ba5c849f4251cdbbf42b2d59e3e21a53e9f48 https://github.com/xwiki/xwiki-dev-llm/commit/512ba5c849f4251cdbbf42b2d59e3… Author: Vincent Massol <vincent(a)massol.net> Date: 2026-09-04 (Fri, 04 Sep 2026) Changed paths: M xwiki/okf/conventions/documentation.md Log Message: ----------- [Misc] Name the cause of the dropped image alt text * PR #110 recorded that xwiki.org renders an image's file name in place of its stored alt, but attributed it to the platform. It is not: on xwiki.org the image macro is DocApp.Code.ImageMacro, a wiki macro of the Documentation Application (org.xwiki.contrib.documentation:documentation-ui, tracked on op.xwiki.org, not JIRA). It declares an alt parameter and then renders the image without it, so the renderer falls back to the file name. Present on master too, and the same application ships an ImageMacroAltCheck that enforces the parameter its own macro discards * The trap now names the macro, which is what makes it actionable: the fix is one line in that XAR, not a platform change 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

[[email protected]][Issue] Updates for HELM-124: Allow the chart to render when customJdbc is omitted
by XWiki Notifications 04 Sep '26

04 Sep '26

1 0