Knowledge Base

The Knowledge Base

Edit

The Knowledge Base is a stand-alone application that hosts every help article published by the company. The same content surfaces in three different views — pick the one matching what you're trying to do.

The three views

  • Public reader at https://mydoc24.org/ — the main browser view, with a hub page, folder pages, and per-article pages. This is what end-users land on when they follow a public link.
  • Admin at /admin — where authors create, edit, publish, and archive content. Only signed-in authors should reach this URL.
  • Chat-widget Help tab inside mywork — a compact reader embedded in the floating chat-widget. Same articles, smaller surface, no top navigation.

The public reader

The hub at / lists every top-level folder as a card with a recursive article count, plus an Uncategorised list of articles that aren't filed under any folder. Click a folder card to open /f/<slug> — that page shows the folder's articles, sub-folders, and a hero banner with breadcrumb. Click an article title to open /a/<slug>.

Each article view has:

  • A breadcrumb at the top showing the folder path.
  • The article body, rendered as sanitised HTML.
  • A sticky On this page TOC sidebar at desktop widths, jumping to each H1/H2/H3 inside the body.
  • A Related articles card grid below the body, auto-derived from each article's keywords plus its heading text. The Related panel is scoped to the article's content cluster — it never pulls in articles from a different top-level folder, so an article in /knowledge-base/editor will never suggest articles from /daily-usage and vice versa.

The admin landing

/admin has two sections — FOLDERS and ARTICLES — rendered as clean div-rows with consistent icons and status pills. The full set of operations is documented in Manage articles and folders.

The + New article button at the top of the page opens /admin/new for a fresh draft. The + New folder card under FOLDERS expands inline; type a name, optionally pick a parent, and click Create.

Every article row has Edit and (for published articles) View links on the right. Folder rows have Rename, Move, and Delete as inline actions that swap the row into edit mode without leaving the page.

The chat-widget Help tab

mywork's floating chat-widget has three tabs at the bottom: Chats, Notifications, and Help. The Help tab renders the Knowledge Base inside a Shadow-DOM-isolated Web Component so the host page's CSS can't bleed into the widget — and the widget's CSS can't bleed out. See The chat-widget Help tab for the full tour, including the click-interception that lets internal /a/<slug> links re-render inside the widget instead of opening a new tab.

Where each role lives

  • Authors spend time in The Editor at /admin/edit/<slug> and in Manage articles and folders at /admin.
  • Readers stay in the public reader or the chat-widget. They shouldn't see admin URLs and don't need to.
  • Agents (Claude / scripts) call the import API directly without touching either the admin or the editor — see the agent API docs.

Storage

Articles, folders, and uploaded blobs live in the kb-app's MySQL database (a separate database on the same MySQL server as mywork). Each article has a status — see Article statuses field definitions for what each one means and where it shows up.

Where to next

Related articles