Help Improvement 4 — Content Gaps (7 Missing Categories)
Status: [To Build]
Purpose: The type system defines 13 help categories but only 6 have content. The 7 empty categories represent features that already exist but have no help documentation — users landing on
/helpsee nothing for DM tools, billing, notifications, AI agents, admin, tenants/users, or system settings.
Topics to Write
Category: dm-tools (DM Portal Tools)
| Slug | Title | Covers |
|---|---|---|
dm-pipeline | Pipeline Management | dm_review → active flow; rejection with feedback; status dropdown rules |
dm-approvals | Approvals Queue | Cross-tenant approval list; type filter; approval actions |
dm-content-briefs | Content Briefs (DM) | Creating briefs for clients; keyword auto-link; generate blog from brief |
dm-social-calendar | Social Calendar (DM) | Read-only calendar view; tile colours; what DM can/cannot edit |
Category: admin (Manage Portal)
| Slug | Title | Covers |
|---|---|---|
admin-deliverable-settings | Deliverable Settings | requireActivityApproval toggle; activityPlannerMaxActivities |
admin-rag-config | RAG & AI Config | Dataset management; role→dataset mapping; pre-loaded vs skill-script |
Category: tenants-users (Manage Portal)
| Slug | Title | Covers |
|---|---|---|
tenants-overview | Managing Tenants | Tenant list; onboarding lifecycle; status transitions |
tenant-detail | Tenant Detail | 16-tab sidebar; Goals/Keywords/Context/Strategy read-only views |
tenant-users | Users & Team Members | Add User modal; TenantMember vs User; role permissions |
tenant-subscriptions | Subscriptions & Plans | Multi-subscription model; plan assignment; credit allocation |
Category: ai-agents (All Portals)
| Slug | Title | Covers |
|---|---|---|
agent-overview | How AI Agents Work | Agent role list; queue model; why jobs take time |
agent-run-stats | Agent Run Statistics | 30-day bar chart; adapter/model breakdown; cost per run |
agent-chat | AI Chat | /chat page; thread history; tool use; phases live vs planned |
agent-skills | Agent Skills | Skills architecture; 15 platform skills; how skills extend agents |
Category: billing (Dashboard + Manage)
| Slug | Title | Covers |
|---|---|---|
credits | Credits & Usage | 26 credit types; creditsPerMonth; /usage page; how credits are consumed |
costs | LLM Costs | /costs page; per-model breakdown; adapter cost tracking |
plans | Plans & Pricing | Plan tiers; features per plan; how plan changes affect credits |
Category: notifications (All Portals)
| Slug | Title | Covers |
|---|---|---|
notifications-overview | Notifications | Notification dropdown; real-time vs REST; types of notifications |
notifications-preferences | Notification Preferences | How to configure what you receive; email vs in-app |
Category: system (Manage Portal)
| Slug | Title | Covers |
|---|---|---|
global-search | Global Search | Ctrl+K modal; Typesense; what is indexed; search scope |
audit-log | Audit Log | Activity log; what events are tracked; filtering |
media-library | Media Library | Image upload/storage; DigitalOcean Spaces; usage in posts |
Implementation Notes
All new topics follow the same HelpPageData shape and are added to:
apps/dashboard/src/app/(dashboard)/help/_data/index.ts(dashboard topics)- Equivalent files in
apps/dmandapps/manageonce those help systems are scaffolded
Each new topic needs:
- An entry in the
_data/index.tsarray - A route file at
help/{slug}/page.tsx(trivial — copies existing pattern) - A
?icon button on the corresponding feature page pointing to the slug
The 7 category labels in HelpCenter are already defined in the HelpCategory type — they will automatically appear in the landing page grid once any page with that category is added.