Content Management

Create and organize your documentation pages.

Understanding the Structure

WPDocs organizes your documentation using two concepts:

  • Sections — Category-like groups displayed in the left sidebar. Each section is a heading like “Getting Started” or “API Reference”.
  • Doc Pages — Individual documentation pages assigned to a section. Each page appears as a link under its section in the sidebar.

This mirrors the structure of popular documentation sites like Tailwind CSS, Stripe Docs, and Laravel.

Creating Sections

  1. Navigate to WPDocs → Sections
  2. Enter a name (e.g., “Core Concepts”)
  3. Set the Order number — lower values appear first in the sidebar
  4. Premium users can pick a section icon from the built-in 50+ icon library
  5. Click Add New Section

Creating Doc Pages

  1. Go to WPDocs → Add New Page
  2. Write your title — this becomes the sidebar link text and page heading
  3. Use the WordPress editor for content. Both the Classic Editor and Block Editor (Gutenberg) are fully supported
  4. In the right sidebar, assign the page to a Section
  5. In the Doc Settings meta box, set the Menu Order (lower = higher in sidebar)
  6. Optionally add a Short Description — shown below the page title on the frontend
  7. Click Publish

Ordering Your Content

Both sections and doc pages are sorted by a numeric order field. Example hierarchy:

Getting Started (section order: 0)
  ├── Installation (menu_order: 0)
  ├── Configuration (menu_order: 1)
  └── Content Management (menu_order: 2)

Theme Structure (section order: 1)
  ├── File Structure (menu_order: 0)
  ├── TailPress Framework (menu_order: 1)
  └── Template System (menu_order: 2)

Writing Good Documentation

The content area uses Tailwind Typography for beautiful defaults. Tips:

  • Use <h2> for main sections and <h3> for sub-sections — these auto-generate the Table of Contents (Premium)
  • Wrap code in <pre><code> blocks for monospace styling
  • Use ordered lists (<ol>) for step-by-step instructions
  • Use tables for structured reference data
  • Keep paragraphs short and scannable

Previous / Next Navigation

Each doc page automatically shows “Previous” and “Next” links at the bottom, following the sidebar order. This lets readers navigate through your docs sequentially.