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/512ba5c849f4251cdbbf42b2d59e3e... Author: Vincent Massol <[email protected]> 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) <[email protected]> To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications