Skip to content

For Professionals — Migration Notice (v1.3.10)

Deprecated in v1.3.10

The docs/for-professionals/ directory is deprecated in FCC v1.3.10 and will be removed in v1.5.0. Its pages remain in place so external links continue to resolve, but new readers should follow the pointers below.

Why the split

FCC v1.3.10 adopts a 9-audience canonical taxonomy that cleanly separates role-oriented concerns:

  • for-beginners
  • for-developers
  • for-educators
  • for-scientists
  • for-architects
  • for-operators
  • for-auditors
  • for-knowledge-engineers
  • for-data-architects

The old for-professionals bucket was a catch-all that mixed integration, deployment, governance, and compliance. These concerns belong in at least three of the new buckets, so keeping the old directory as a "professionals overview" would have confused more readers than it helped.

Where the content moved

The table below maps every page in the legacy directory to its new home.

Legacy page Primary destination Secondary destination
index.md For Developers For Architects
enterprise-deployment.md For Operators — Deployment For Architects — Enterprise Patterns
governance-compliance.md For Auditors — Governance For Architects — Compliance Patterns
integration-guide.md For Developers — Integration For Architects — Integration Patterns
ai-compliance.md For Auditors — AI Compliance
cost-analysis.md For Operators — Cost Planning For Architects — TCO
security-review.md For Auditors — Security Review For Operators — Security Hardening
quickstart-enterprise.md For Operators — Quickstart For Architects — Quickstart

Primary vs secondary destinations

The primary destination is the best fit for the full page. The secondary destination covers an orthogonal slice of the same content (e.g. the patterns inside a deployment guide rather than the procedures).

What happens to the old pages

Each legacy page now carries a deprecation banner at the top explaining the migration. The pages themselves have not been edited or truncated — they remain a faithful v1.3.9 snapshot so that external links and search-engine results still land on working content.

The pages will be frozen (no further edits) through v1.4.x and will be removed in v1.5.0 along with this migration guide.

For external linkers

If you maintain external references to pages in this directory:

  1. Update your links to point to the new audience section before v1.5.0.
  2. If your system has a canonical URL, consider updating it to the primary destination from the table above.
  3. If you are unsure which destination is right, use the Audience Cross-Links matrix as a decision aid — every legacy topic appears there with its new audience mapping.

For contributors

New content must not be added to for-professionals/. Use the audience cross-links matrix to pick the correct destination and open the PR there. If your topic doesn't fit any of the nine audiences, open an issue — the taxonomy is deliberately flat and we want to keep it that way.

See also