Skip to content

User Docs Migration Matrix

This matrix maps current documentation to user-doc actions for the docs-user/ rollout.

Legend:

  • reuse: can be linked with minimal rewrite
  • rewrite: content useful but needs user-facing rewrite
  • engineering-only: keep in docs/, do not place in primary user nav
  • defer: not required in initial launch
SourceAudience todayActionTarget in docs-user/
docs/README.mdmixedrewriteREADME.md + section indexes
docs/MASTER_DATA.mdmixedrewriteworkflows/countries.md, workflows/currencies.md, reference/data-dictionary.md
docs/ssi/SSI_UI_SCHEMA.mdmixedrewriteworkflows/ssi.md, reference/data-dictionary.md
docs/lei/LEI_QUICKSTART.mdmixedrewriteworkflows/lei-records.md
docs/lei/LEI_IMPLEMENTATION_SUMMARY.mdengineering-heavyengineering-onlyn/a
docs/lei/LEI_DATA_FLOW.mdengineering-heavyengineering-onlyn/a
docs/i18n/INTERNATIONALISATION.mdmixedrewriteadmin/translation-review.md
docs/ui-patterns.mdengineeringengineering-onlyn/a
docs/environments/*engineering/opsengineering-onlyn/a
docs/performance/*engineeringengineering-onlyn/a
docs/security/*engineering/securityengineering-onlyn/a
docs/adr/*engineering/architectureengineering-onlyn/a
README.md (root)mixedreusecross-link from docs-user/README.md

Initial Priority Wave

Priority 1 pages:

  1. getting-started/sign-in-and-access.md
  2. getting-started/navigation-basics.md
  3. workflows/lei-records.md
  4. workflows/ssi.md
  5. admin/user-approvals.md
  6. reference/data-dictionary.md

Priority 2 pages:

  1. workflows/countries.md
  2. workflows/currencies.md
  3. workflows/entities.md
  4. workflows/instruments.md
  5. workflows/accounts.md
  6. troubleshooting/common-errors.md

Success Criteria

  • A new user can complete core workflows without reading engineering docs.
  • Admin users can perform approval/review workflows via user-doc pages.
  • Data dictionary covers primary fields used in core workflows.
  • Primary user nav contains only user-facing pages.

Axiom Financial Services Static Data Platform