Troubleshooting

Troubleshooting

Cover missing data, stale readings, unavailable reports, map display issues, help-topic gaps, permission problems, publication recurrence limitations, and unexpected navigation states.

Source Validation Notes

Validated source findings:

1. Home is currently a benefits/landing surface, not an operational dashboard.
2. /agents is the active agent operations screen; /agent-log exists but is placeholder-like.
3. Help content is exported into webfront/src/config/siteHelpContent.ts and mapped by route in webfront/src/config/helpContent.ts.
4. Searchable help is implemented by searching exported site help entries.
5. Reports, maps, exports, publications, people/profile, and readings all have visible UI surfaces in the current source.

Remaining Decisions

1. Decide which engineering/admin pages are customer-facing.
2. Decide how much of People/user administration belongs in customer documentation.
3. Decide whether publication destinations are documented as production-ready or advanced/admin features.
4. Capture screenshots for page-level help.
5. Define the machine-readable help topic format for future in-app extraction.

Related Documents

• help-topics-inventory.md
• app-source-validation-notes.md
• ../market/product-overview.md
• ../market/data-reporting-and-measurement-outputs.md

Source Context

This page was split from the GreenSparks user guide outline and should be expanded into workflow-oriented documentation.