🌐 Qwiki Manual
User Guide / Collaboration & Workflow / Comments & Editorial Talk Pages

Comments & Editorial Talk Pages

Standalone Qwiki separates reader feedback from editorial collaboration using two lightweight, zero-database discussion extensions: Document Comments (tool-comments) and Talk Pages (tool-talk).

Editorial Talk Page tab switcher alongside the Document reading view

Document Comments (tool-comments)

Comments appear in the footer beneath a chapter when enabled by your administrator:

  • Who can participate: Authenticated users (viewer and admin) can post comments, edit or delete their own comments, and reply in 1-level threads.
  • Safe Formatting: Supports restricted Markdown formatting with live preview and strict XSS sanitization.
  • Best for: Reader Q&A, clarification requests, and lightweight feedback attached directly below the finished page.

Editorial Talk Pages (tool-talk)

Inspired by Wikipedia, Talk Pages keep public documentation clean while giving editors a dedicated workspace to debate structure, track open questions, and archive resolved proposals.

  • Header Tab Switcher: Enabled chapters display a clean [ 📄 Document | 🗣️ Discussion (N) ] toggle above the reading body.
  • Topic Threads & Replies: Start new discussion topics under structured ## Subject headings or post quick replies (rendered with author initials avatars, role badges, and timestamps).
  • Raw Markdown Editing & Archiving: Authorized editors and admins can switch into raw Markdown mode to refactor long discussions, summarize decisions, or archive settled threads.
  • Opt-In Cascading Inheritance: Administrators enable Talk Pages per category (disabled by default) and can override any individual chapter to Inherit from category (Default), Enabled, or Disabled.
Note

Both Comments and Talk Pages can be retrieved programmatically via api/llm.php (for example, mode=doc&include_comments=1&include_talk=1) so AI assistants can summarize open editorial feedback. See the Controlled LLM Access API.