Skip to content

Docs/restructure files to match nav - #11

Merged
tonyopenbox merged 3 commits into
developfrom
docs/restructure-files-to-match-nav
Feb 20, 2026
Merged

Docs/restructure files to match nav#11
tonyopenbox merged 3 commits into
developfrom
docs/restructure-files-to-match-nav

Conversation

@tonyopenbox

Copy link
Copy Markdown
Collaborator

Summary

Restructure the docs filesystem so that file paths match the sidebar navigation hierarchy. Previously, files were spread across directories (agents/, concepts/, sdk/, compliance/, organization/) that didn't align with how content is grouped in the sidebar. This PR moves and renames files so the URL structure and directory layout mirror the navigation.

Changes

Sidebar (sidebars.js)

  • Getting Started category now uses a link to its index doc instead of listing it as a child item; registering-agents moved here from agents/
  • Core Concepts category items now reference core-concepts/ instead of concepts/
  • Trust Lifecycle promoted to a top-level category (was nested under agents/); uses a link to its index doc; all phase docs reference trust-lifecycle/ instead of agents/trust-lifecycle/; agents/overview moved into this category
  • Developer Guide is a new category consolidating SDK docs (sdk/) and the Temporal integration guide (getting-started/workflow-engines/temporal); event-types moved here from concepts/
  • Dashboard category now uses a link to its index doc; agents/index moved here as dashboard/agents
  • Administration is a new category consolidating organization/ and compliance/ docs

Temporal Integration Guide

  • Renamed from "Temporal (Python)" to "Temporal Integration Guide (Python)" with a sidebar_label: Temporal (Python) to keep the sidebar compact

Internal links

  • All cross-references across every doc updated to reflect the new paths
  • Glossary links updated throughout
  • Homepage cards (index.md) updated to point to new paths
  • Landing page (src/pages/index.js) explore section links updated

LLM index (static/llms.txt)

  • Completely restructured to match the new sidebar sections
  • Added previously missing entries (Troubleshooting, Session Replay, Overview, Agents under Dashboard)
  • Removed stale section headers (Agents, Concepts, SDK, Organization, Compliance)
  • Added new section headers (Core Concepts, Trust Lifecycle, Developer Guide, Administration, Reference)

File Mappings

agents/ → split across multiple directories

Old Path New Path
agents/index.md dashboard/agents.md
agents/overview.md trust-lifecycle/overview.md
agents/registering-agents.md getting-started/registering-agents.md
agents/trust-lifecycle/index.md trust-lifecycle/index.md
agents/trust-lifecycle/assess.md trust-lifecycle/assess.md
agents/trust-lifecycle/authorize.md trust-lifecycle/authorize.md
agents/trust-lifecycle/monitor.md trust-lifecycle/monitor.md
agents/trust-lifecycle/verify.md trust-lifecycle/verify.md
agents/trust-lifecycle/session-replay.md trust-lifecycle/session-replay.md
agents/trust-lifecycle/adapt.md trust-lifecycle/adapt.md

concepts/ → split across core-concepts/ and developer-guide/

Old Path New Path
concepts/trust-scores.md core-concepts/trust-scores.md
concepts/trust-tiers.md core-concepts/trust-tiers.md
concepts/governance-decisions.md core-concepts/governance-decisions.md
concepts/event-types.md developer-guide/event-types.md

sdk/developer-guide/

Old Path New Path
sdk/index.md developer-guide/sdk-reference.md
sdk/configuration.md developer-guide/configuration.md
sdk/error-handling.md developer-guide/error-handling.md

getting-started/workflow-engines/developer-guide/

Old Path New Path
getting-started/workflow-engines/temporal.md developer-guide/temporal-integration-guide-python.md

compliance/administration/

Old Path New Path
compliance/index.md administration/compliance-and-audit.md
compliance/attestation.md administration/attestation-and-cryptographic-proof.md

organization/administration/

Old Path New Path
organization/index.md administration/organization.md
organization/audit-log.md administration/organization-audit-log.md

Files modified in place (not moved)

File What changed
api/index.md Updated internal links to new paths
approvals/index.md Updated internal links to new paths
compliance/frameworks.md Updated internal links to new paths
dashboard/index.md Updated internal links to new paths
dashboard/alerts.md Updated internal links to new paths
dashboard/trust-overview.md Updated internal links to new paths
getting-started/index.md Updated Temporal integration link
getting-started/quick-start.md Updated all internal links to new paths
getting-started/troubleshooting.md Updated internal links to new paths
glossary.md Updated all 19 "Learn more" links to new paths
index.md Updated homepage card links to new paths
src/pages/index.js Updated explore section links
static/llms.txt Restructured sections and URLs to match new layout
sidebars.js Restructured to use new file paths and added category links

Move and rename doc files so the filesystem mirrors the sidebar hierarchy:

agents split into trust-lifecycle, dashboard, and getting-started
concepts becomes core-concepts
sdk becomes developer-guide
compliance and organization consolidated under administration

Update sidebar_position, cross-references, and internal links across all affected pages.
@tonyopenbox
tonyopenbox requested a review from nat294 February 20, 2026 05:52
@tonyopenbox tonyopenbox self-assigned this Feb 20, 2026
@vercel

vercel Bot commented Feb 20, 2026

Copy link
Copy Markdown

@tonyopenbox must be a member of the Platform team on Vercel to deploy.
- Click here to add @tonyopenbox to the team.
- If you initiated this build, request access.
- If you're already a member of the Platform team, make sure that your Vercel account is connected to your GitHub account.

Learn more about collaboration on Vercel and other options here.

@tonyopenbox
tonyopenbox marked this pull request as ready for review February 20, 2026 05:55
Comment thread website/docs/approvals/index.md
@tonyopenbox
tonyopenbox merged commit f6a91a1 into develop Feb 20, 2026
1 check failed
@tonyopenbox
tonyopenbox deleted the docs/restructure-files-to-match-nav branch February 20, 2026 07:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants