Area: Forums (audit p2) · Surface: GET /thread/{slug}/jump-unread (ForumController@jumpUnread); GET /forums/new (showAllUnread); POST /forums/mark-all-read; POST /forums/{slug}/mark-read; POST /forums/category/{slug}/mark-read · Dimension: documentation · Severity: minor
The whole unread-tracking subsystem — the "Jump to first unread" button on every thread, the /forums/new all-unread view, and the mark-all-read / mark-forum-read / mark-category-read actions — is entirely undocumented. New members get no guidance on how unread state works or how to clear it, despite these being prominent buttons in the forum and thread chrome.
Evidence
User-facing UI confirmed: platform/templates/forums/thread.php:742 `<a href="/thread/<?= $e($thread['slug']) ?>/jump-unread" class="btn btn--outline btn--sm">Jump to first unread ↓</a>`; routes.php exposes /forums/new (showAllUnread), /forums/mark-all-read, /forums/{slug}/mark-read, /forums/category/{slug}/mark-read, /forums/{slug}/unread. Wiki check: across all 71 /know articles, `grep -riE 'jump.{0,6}unread'` = NONE; index body has "jump to unread" 0 times and "jump-unread" 0 times. The only "jump"/"unread" hits in thread-features.html are incidental nav chrome ("Unread" menu item) and "jump over to a desktop". `grep mark.{0,6}read` across all articles matched only "mark a thread as a Staff Pick" in thread-features — i.e. mark-as-read is undocumented. https://support.mobieus.io/know/search?q=unread returns "No results".
Suggested fix. Add a /know article (e.g. /know/unread-tracking) explaining: how unread is tracked, the "Jump to first unread" thread button, the "Unread"/New view at /forums/new, and the Mark all read / Mark forum read / Mark category read actions. Link from forums-and-discussions and notifications.
Filed by the automated tenant-app audit and adversarially evidence-verified. Status: verified. Open — not yet actioned.
Patrick Bass
@mobieus