Skip to main content

Documentation Index

Fetch the complete documentation index at: https://fieldpulse.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
ET-507 — Category Changes (Help Center IA migration)

Full approved plan: see the session plan (mirrors old Intercom HC’s 8 collections). Builds on ET-453’s custom sidebar. Decisions: extend custom sidebar, reconstruct hierarchy from local data, full migration, 2-level sidebar (collections → sub-categories) collapsed-except-active, articles reached via card grids.

​
Target IA — 8 collections (verified against live help.fieldpulse.com)

Getting Started · Using FieldPulse · Features & Add-Ons · Integrations & Partners · Offline Mode · Training & Resources · What’s New · Troubleshooting & Technical Specs. Live-confirmed placements: Accounting (QBO/QBD/Xero/MYOB) → Integrations & Partners; monthly recaps → What’s New (by year); User Management → Using FieldPulse › Users & Teams.

​
Pipeline (single source of truth = the tree)

  1. scripts/build-et507-tree.mjs → _meta/et-507-target-tree.json (collection → sub-category → [routes]). Maps current docs.json modules to the 8 collections + carves scattered ones by route pattern.
  2. scripts/generate-sidebar-nav.mjs → sidebar-nav-data.js (window.__FP_SIDEBAR_NAV, root .js, auto-included).
  3. docs-sidebar.js consumes window.__FP_SIDEBAR_NAV; renders 8 collapsible collections → sub-category links; collapsed-except-active; reuses landing-nav.js toggle + .hc-nav-* CSS (home look).

​
Remaining

  • 3 carved-collection landing pages (offline-mode/index.mdx, training-resources/index.mdx, troubleshooting/index.mdx) — the only sidebar links that 404 today (62/65 resolve).
  • Card grids + category icons on sub-category landing pages (the “level before a doc”): restore scripts/generate-category-cards.mjs (tag et-453-parked-restyle), add per-category Card icons.
  • Breadcrumbs on articles — custom (tree-based article-breadcrumb.js) preferred for first pass to avoid restructuring docs.json (native sidebar is hidden, routing already works; native breadcrumbs would require re-grouping ~500 pages incl. hidden Engineering groups — deferred).
  • TOC — native Mintlify, already present.

​
Deferred (follow-up)

docs.json restructure into the 8 collections (for native breadcrumbs + search hierarchy); physically moving scattered files; truing the tree against the live Intercom API (needs INTERCOM_API_TOKEN).

​
QA

mint dev + Playwright: 8 collections render, collapse/expand, active auto-expand, dark + mobile; all sub-category links resolve; card grids list every article; breadcrumbs on articles. Evidence → .qa/ET-507/.