{
  "categories": [
    {
      "name": "Documentation Basics",
      "faq": [
        {
          "question": "How do I create project docs?",
          "answer": "Run **install-atomic.php** or **admin/docs-regenerate.php**. This generates:\n\n- `project.md`\n- `api.md`\n- `guide.md`\n- `architecture.md`\n- `scan.md`"
        },
        {
          "question": "Can I edit the docs manually?",
          "answer": "Yes. All docs live in `/docs/<section>/*.md`. You can edit them in any Markdown editor. Manual edits are preserved unless you regenerate."
        },
        {
          "question": "How do I view all docs?",
          "answer": "Browser: Visit `/admin/docs.php`.\nTerminal: Open any `.md` file in `/docs/`."
        }
      ]
    },
    {
      "name": "Admin Tools",
      "faq": [
        {
          "question": "What admin tools are available?",
          "answer": "Your admin suite includes:\n\n- `docs.php` — View all documentation\n- `docs-audit.php` — Validate docs against manifest\n- `docs-regenerate.php` — Rebuild all docs\n- `health-check.php` — Validate system integrity\n- `module-check.php` — Ensure modules exist and reinstall if missing"
        },
        {
          "question": "What can be run from the browser?",
          "answer": "- Docs viewer\n- Audit\n- Regenerate\n- Health check\n- FAQ editor\n- FAQ viewer"
        },
        {
          "question": "What can be run from the terminal?",
          "answer": "- `php install-atomic.php`\n- `php test-system.php`\n- `php admin/docs-regenerate.php`\n- `php admin/docs-audit.php`\n- `php admin/health-check.php`\n- `php admin/module-check.php`"
        }
      ]
    },
    {
      "name": "System Overview",
      "faq": [
        {
          "question": "What can the system do?",
          "answer": "Your documentation engine provides:\n\n- Automatic project documentation\n- Automatic API documentation\n- Automatic architecture documentation\n- Automatic project scanning\n- Automatic regeneration\n- Automatic auditing\n- Automatic health checking\n- Self-healing module installation\n- Unified atomic installer\n- Unified atomic test script\n- Browser admin dashboard\n- Terminal-friendly commands\n- Manifest-driven structure\n- Portable module repository\n- Zero manual configuration"
        },
        {
          "question": "What are the main subsystems?",
          "answer": "1. **Documentation Builders** — `/includes/`\n2. **Admin Tools** — `/admin/`\n3. **System Modules** — `/system-modules/`\n4. **Installers & Testers** — atomic installer, test script, audit, health check"
        }
      ]
    },
    {
      "name": "FAQ System",
      "faq": [
        {
          "question": "How do I manage the FAQ?",
          "answer": "Use `/admin/faq.php` to add, edit, or delete FAQ entries. All changes are saved to `config/faq.json`."
        },
        {
          "question": "Where is the FAQ stored?",
          "answer": "The FAQ is stored in `config/faq.json` and can be edited manually or through the admin UI."
        },
        {
          "question": "Can I reorder FAQ entries?",
          "answer": "Yes. Delete and re-add entries in the desired order, or manually reorder them in `faq.json`."
        },
        {
          "question": "Does regenerating docs overwrite manual edits?",
          "answer": "No. Only builder-generated files are overwritten. Manual edits to Markdown files remain intact."
        },
        {
          "question": "How do I test the entire system?",
          "answer": "Run `test-system.php` to validate builders, modules, docs, audit, health check, and FAQ."
        }
      ]
    }
  ]
}

