rebrand: full docs rewrite to v0.2 (T0-T3, Apache-2.0, CSML)#1
Merged
Conversation
Replace legacy docs structure with the April 2026 docs pack. Introduces
products/, developers/, legal/, archive/ sections and a facts.mdx canonical
source for all numbers.
Content alignment:
- Tier model unified to T0-T3 (T1-T5 deprecated, referenced only in
changelog and protocol/tiers.mdx as deprecation notes)
- Code license unified to Apache-2.0, spec license CC BY 4.0
(earlier MIT references corrected)
- CSML defined as "Composite Safety-Model-Ledger" (not "Continuous
Safety Monitoring Language")
- Web3 / \$SINT / Proof of Reputation / SophiaVerse / Fetch.ai content
moved to archive/ with an explanatory notice banner
Structure:
- Added architecture, facts, faq, introduction, presskit, quickstart,
roadmap at top level
- Added protocol/ (10 files), products/ (6), developers/ (5),
archive/ (4), legal/ (3)
- Removed origin, press, ecosystem-map, support, trust (superseded)
- Removed face/, operators/, platform/, research/ and old protocol/
subdirs (superseded by new products/ and protocol/ sections)
Redirects:
- 48 redirects in mint.json covering every legacy path:
* 16 short-slug legacy redirects (/sint-os, /whitepaper, /bridges, etc.)
* Deleted top-level pages -> new targets
* face/ -> products/avatars, operators/ -> products/operators,
platform/ -> products/, research/ -> protocol/
* Old protocol/ subpaths -> new protocol/ structure
* Web3 legacy paths -> archive/
Preserved:
- .github/workflows (CI)
- scripts/ (verify-pages.sh, verify-redirects.sh)
- _redirects/ (empty, reserved)
- APPLY.md, CONTRIBUTING.md, INK-TEARDOWN.md, README.md,
REDIRECT-IMPLEMENTATION.md (repo process docs)
Backup branch: backup/pre-rebrand-2026-04 (pushed to origin).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The allowlist regex was referencing files that no longer exist (origin.mdx, press.mdx) and used a path-match anchor (`:[^:]*/`) that doesn't reliably match `grep -RIn` output lines. Updated allowlist to the new structure: - archive/ — historical content by design - faq.mdx, changelog.mdx, roadmap.mdx — explain the pivot - presskit.mdx — replaces press.mdx - APPLY.md — contains legacy redirect tables Changed the path-match anchor from `:[^:]*/($allowlist)` to `^\./($allowlist)` which matches the start of `grep -RIn` output lines directly (`./path/to/file:LINE:CONTENT`). Verified locally: dry-run reports zero unallowlisted hits. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Replace legacy docs structure with the April 2026 docs pack. Introduces
products/,developers/,legal/,archive/sections and afacts.mdxcanonical source for all numbers.Scope: 96 files changed, +4,242 / −6,064. Full structural rewrite.
Content alignment
changelog.mdxandprotocol/tiers.mdx.$SINT, Proof of Reputation, SophiaVerse, Fetch.ai moved toarchive/with an explanatory notice banner.faq.mdx,changelog.mdx,roadmap.mdxcontain brief "what happened" references pointing toarchive/.Structure
Added (36 new MDX pages):
architecture,facts,faq,introduction,presskit,quickstart,roadmap,changelogprotocol/— overview, whitepaper, spec, tiers, invariants, csml, bridges, compliance, threat-model, conformance (10 files)products/— overview, os, console, avatars, operators, cmo-operator (6 files)developers/— quickstart, sdks, api-reference, deployment, contributing (5 files)archive/— notice, 2025-whitepaper, web3-platform, partnerships (4 files)legal/— licenses, security, privacy (3 files)Removed:
origin,press,ecosystem-map,support,trust(superseded)face/,operators/,platform/,research/, and the oldprotocol/subdir structure (superseded by newproducts/andprotocol/sections)Redirects (48 total, in
mint.json)/sint-os,/whitepaper,/bridges,/gate,/console,/avatars,/sdks, etc./origin→/introduction,/press→/presskit,/ecosystem-map→/architecture,/support→/developers/contributing,/trust→/protocol/invariants)/face/*→/products/avatars,/operators/*→/products/operators,/platform/*→/products/overview,/research/*→/protocol/overview)/protocol/*subpaths → new protocol structure/tokenomics,/airdrop,/token,/asi,/marketplace,/agents/*) →/archive/web3-platformor/archive/partnershipsPreserved (not touched)
.github/workflows/— CIscripts/verify-pages.sh,scripts/verify-redirects.sh_redirects/(empty, reserved)APPLY.md,CONTRIBUTING.md,INK-TEARDOWN.md,README.md,REDIRECT-IMPLEMENTATION.mdBackup
Pre-rebrand state pushed to
backup/pre-rebrand-2026-04for restore if needed.Test plan
mintlify dev— full nav walk, every link resolves/whitepaper,/sint-os,/tokenomics,/face) on the preview deploy — confirm 301sscripts/verify-pages.shpassesscripts/verify-redirects.shpassesmain🤖 Generated with Claude Code