Skip to content

docs-06: Restructure Modules Docs Site Information Architecture #95

@djm81

Description

@djm81

Summary

Restructure the modules docs site from 6 flat sidebar sections to 7 focused sections with per-bundle organization: Getting Started, Bundles, Workflows, Integrations, Team & Enterprise, Authoring, Reference.

OpenSpec Change

  • Change folder: openspec/changes/docs-06-modules-site-ia-restructure/
  • Priority: P0 (foundational)

Scope

  • Create bundles/{backlog,project,codebase,spec,govern,code-review}/ directories
  • Create workflows/, integrations/, team-and-enterprise/, authoring/ directories
  • Move 15+ guide files from flat guides/ to bundle/workflow/authoring locations
  • Update sidebar navigation with collapsible bundle groups
  • Rewrite landing page as bundle-focused
  • Add jekyll-redirect-from entries

Source Plan

specfact-cli-internal/docs/internal/implementation/2026-03-23-docs-refactoring-beginner-to-enterprise-plan.md

Metadata

Metadata

Assignees

Labels

change-proposalProposal for a new changedocumentationImprovements or additions to documentationopenspecopenspec change

Projects

Status

In Progress

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions