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 — QA Notes (Category Changes, first pass)

​
Approach

Mirror the old Intercom HC’s 8 collections via a custom desktop sidebar (extends ET-453), driven by a single source of truth: _meta/et-507-target-tree.json → sidebar-nav-data.js (window.__FP_SIDEBAR_NAV + window.__FP_BREADCRUMBS). Reconstructed from local data; the 3 scattered collections (Offline Mode, Training & Resources, Troubleshooting) grouped by reference (no file moves). Placements verified against live help.fieldpulse.com.

​
Verified (local mint dev + Playwright/Chrome)

  • 8 collections render in the desktop sidebar; collapse/expand at the top level (which native Mintlify can’t); collapsed-except-active; active article auto-expands its collection.
  • All 65 sub-category links resolve (3 carved-collection landings created: /offline-mode, /training-resources, /troubleshooting, each a card grid).
  • Breadcrumbs — “Collection / Sub-category” at the top of each article header, tree-driven; the native eyebrow (old grouping) is hidden where our breadcrumb is injected.
  • Accounting highlights under Integrations & Partners; What’s New grouped by year.
  • SPA navigation persistence + active-state update verified (ET-453 behavior.mjs).
  • Native right-rail TOC intact.

​
Known limitations (documented follow-ups; tracked for the docs.json restructure)

  1. Mobile drawer shows the OLD grouping. The custom sidebar only transforms the desktop #sidebar; the mobile menu is a separate native Mintlify component reflecting the current (un-restructured) docs.json. Fix = restructure docs.json into the 8 collections (deferred).
  2. Card coverage on the ~20 existing sub-category landing pages not yet applied (held per Ross). Most pages already have curated cards. scripts/generate-category-cards.mjs is staged (needs a de-dup tweak so general-ui-ux/index doesn’t re-card articles moved to other collections).
  3. What’s New sub-category sidebar links point at /core-platform/general-ui-ux (the recaps’ directory) rather than dedicated year landing pages — minor; follow-up.
  4. Native breadcrumbs / search / mobile reflect the old grouping until docs.json is restructured; we use custom (desktop) breadcrumbs in the meantime.
  5. Getting Started › General is a 36-article catch-all (live HC’s Getting Started is more curated); refine in a later pass.
  6. Dark mode: local mint renders the dark canvas unreliably — verify on the PR preview deploy. Our component dark CSS (.dark .hc-nav-*, .dark .fp-breadcrumb) is in place.

​
Screenshots

sidebar-8collections.png, article-breadcrumb.png, offline-landing.png, dark-full.png, mobile.png, mobile-drawer.png (shows the native mobile menu limitation).