[thekannen]

Closes #143.

The in-app Help page was a third copy of the user docs. It now gives a short intro per topic and links to the matching page on https://knownframe.com/cookdex/docs/, so the site is the one place user docs live.

What changed

• Help page (HelpPage.jsx, constants.js). HELP_PLACES, HELP_SETUP_GUIDES, HELP_TASK_GUIDES, HELP_FAQ and HELP_TROUBLESHOOTING are gone, about 340 lines. In their place:

  • a Documentation card linking to the docs home;

  • First steps, a short checklist kept in the app (see below), with a link to Getting started;

  • one card per topic, each with one sentence and its links:

    Card	Links to
    The places in CookDex	getting-started/#where-things-are
    Connecting things	install/, getting-started/#sign-in-and-connect-mealie, database-connection/
    Jobs in Tools	tasks/, tasks/data-maintenance/, tasks/backups-and-cleanup/, tasks/taxonomy/, recipe-dredger/
    Scheduling and safety	scheduling/, safety-policies/
    Privacy	privacy-and-safety/, https://knownframe.com/privacy/cookdex/
    When something's wrong	troubleshooting/

  The FAQ answers are on the docs pages they belong to, and the Documentation card covers the "Questions" entry point.

• Kept as before: Report a problem (make, preview and download the diagnostics report) and Open a GitHub issue (/issues/new).

• About page: a Documentation link at the top of Project Links. The server adds links.docs to GET /about/meta, and both pages fall back to the same URL in constants.js.

• Tools (the optional item): each job's sheet has a More about this job link to its section, such as tasks/data-maintenance/#ingredient-parse. The Dredger links to recipe-dredger/. test_help_task_guide_ids_match_registry becomes test_task_doc_links_match_registry, so every registered task still has to have a docs link, and a link to a removed task fails the test.

• Removed GET /help/docs, along with _HELP_DOCS and _build_help_docs_payload in routers/meta.py. It read docs/*.md, which .dockerignore excludes, so in the image it always returned an empty list. One of its files, PARSER_MIGRATION.md, didn't exist, and no page called the endpoint.

• Smoke test: the /help/docs call is gone. The Help check used to open the FAQ and guide accordions; it now checks that each card's links point at knownframe.com, that the troubleshooting link is right, and that no long-form accordions are left. The About check also looks for the Documentation link. The markers help:faq-open and help:task-guides-open are now help:docs-links and help:troubleshooting-link.

• CSS for the old guides (.guide-*, .accordion-group-label) is removed, and a small .help-links and .job-docs-link are added.

Kept in the app for offline and LAN-only installs

The default is an intro plus links. I kept only one thing that's useful without internet access:

• First steps (4 lines: connect Mealie, scan, review the findings, turn on an automation). It's what someone needs on a first run, before they know whether the docs site is reachable. Each line points at an in-app page, not at docs content, and the card links to Getting started for the full text.

Things I considered keeping and dropped:

• "Can't reach Mealie" tips, such as localhost inside Docker. Test Mealie in Settings already returns that hint when the address is localhost inside a container (settings_api.py).
• What preview means. The job sheet and the Tools header already say a preview changes nothing.
• Reading a failed run. The troubleshooting card's one-line intro says each run's details and Technical details are in Recent activity.

Overlap with #144

#144 merged while this was open. I merged main into this branch:

• docs/TASKS.md: took main's version, since the routes list moved out of it.
• docs/API.md: removed its GET /help/docs line.
• AGENTS.md / CONTRIBUTING.md: Point user docs at knownframe.com #144 added the note that user docs live on knownframe.com. I added one sentence to each saying the in-app Help page and job sheets link there, so new help text goes on the site and not into web/src/constants.js. That covers the issue's last "Done when" item.

Screenshots

These were taken from the running app with no Mealie connected, which is why the banner is showing. The images were added in a separate commit and removed in the next one, so they never reach the tree on main.

Help, light	Help, dark

About	Job sheet in Tools

Verification

• python -m pytest: all tests pass. ruff check src tests is clean.
• npm --prefix web test: 67/67 pass on Node 22. npm --prefix web run build succeeds.
• scripts/qa/run_local_webui_qa.py --iterations 1 (the CI smoke test): passed with 16 checks.
• I curled every knownframe.com URL the app now links to: each returns 200, and each #fragment exists as an id on its page. That's the 14 pages plus the 11 anchors used: where-things-are, sign-in-and-connect-mealie, clean-recipes, slug-repair, ingredient-parse, yield-normalize, reimport-recipes, health-check, tag-categorize, cleanup-duplicates and mealie-backup.

🤖 Generated with Claude Code