Post-image alt-text editing & AI alt-text suggestions not documented (only Markdown alt syntax is)

Area: Forums (audit p2) · Surface: POST /forum/post/{postId}/image/{imageId}/alt-text (ForumController@setImageAltText); UI in platform/templates/partials/post-images-input.php + profile/settings.php AI toggle · Dimension: documentation · Severity: minor

The forum image-upload flow lets users set/edit alt text on uploaded post images and offers an AI alt-text suggestion toggle in profile settings, but the wiki only documents the Markdown `![Alt text]` syntax. The dedicated alt-text editing UI and the AI suggestion feature (an accessibility affordance) are undocumented, so users won't discover them.

Evidence

Feature is user-facing: routes.php:1182 exposes /forum/post/{postId}/image/{imageId}/alt-text; platform/templates/partials/post-images-gallery.php uses `$img['alt_text']` for posted images; platform/templates/partials/post-images-input.php:61 shows "Tip: enable <em>AI alt-text suggestions</em> in..."; platform/templates/profile/settings.php:406 has the toggle "Use AI to suggest alt-text on my uploaded images". Wiki check: the only article mentioning alt text is markdown-guide.html, and its sole match is the Markdown image syntax example `![Alt text](https://example.com/image.jpg)` — it does NOT document editing alt text on already-uploaded forum-post images or the AI alt-text suggestion setting. Index body has "alt text"/"alt-text" 0 times; search q=alt+text returns no article.

Suggested fix. Extend markdown-guide (or add a short Images/Accessibility article) covering: adding/editing alt text on uploaded post images, why alt text matters for accessibility, and enabling "AI alt-text suggestions" in profile settings.

Filed by the automated tenant-app audit and adversarially evidence-verified. Status: verified. Open — not yet actioned.