Skip to content

[product-pages] Replace 11 {{TODO}} tutorial stubs with real walkthroughs #81

Description

@rubenvdlinde

Source: AUDIT-product-pages-2026-05-13.md fleet audit · finding: all 11 tutorial pages under docs/tutorials/ are pure {{TODO}} stubs

The migration PR renames tutorials/user-guide/ and keeps the existing files. This issue tracks replacing the {{TODO}} placeholders with real walkthroughs.

Files

  • user-guide/user/01-first-launch.md
  • user-guide/user/02-send-invoice.md
  • user-guide/user/03-record-expense.md
  • user-guide/user/04-bank-reconcile.md
  • user-guide/user/05-quarterly-vat.md
  • user-guide/user/06-procurement-request.md
  • user-guide/user/07-contract-renewal.md
  • user-guide/user/08-year-end-close.md
  • user-guide/admin/01-chart-of-accounts.md
  • user-guide/admin/02-vat-codes.md
  • user-guide/admin/03-approval-chains.md

Each page should contain

  • Goal — one sentence, MKB-direct, what the reader will achieve.
  • Prerequisites — one bullet list of what needs to be set up first.
  • Steps — numbered, action-driven. Screenshots where the UI is non-obvious.
  • Verification — how to know it worked.
  • Common issues — known gotchas with the fix.
  • Reference — links to the relevant Features/ page or API doc.

Use the openregister user-guide/ pages as a structural template (e.g. openregister/docs/user/).

Acceptance

  • No {{TODO}} placeholders remain in any of the 11 pages.
  • Each page passes the writing rules in design-system/CLAUDE.md.
  • At least one real screenshot per user-track page.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationproduct-pages-auditAudit finding from 2026-05-13 fleet review against design-system product-pages spectier:3Content authoring, separate sprint

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions