Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 22, 2026

Reorganized documentation from flat specifications/ structure to three-layer architecture defined in enterprise-framework.mdx.

Structure Changes

Before:

docs/specifications/{sdk,cli,deployment,objectql,objectos,objectui}

After:

docs/
├── creator-layer/      # SDK, CLI
├── governance-layer/   # Deployment, CI/CD  
└── execution-layer/    # ObjectQL, ObjectOS, ObjectUI

Implementation

  • New layer index pages: Created comprehensive English + Chinese overview pages for each layer explaining purpose, philosophy, and integration points
  • Content migration: Moved 64 files from specifications/* to appropriate layer directories
  • Navigation updates:
    • Updated meta.json hierarchy to reflect three-layer model
    • Updated cross-references in enterprise-framework.mdx to point to new locations
    • Converted specifications/ to redirect/overview page for backward compatibility

Visual Result

New sidebar navigation showing architectural flow:

Documentation Structure

Creator Layer landing page with detailed developer workflow:

Creator Layer

Technical Notes

  • Zero content changes to existing spec files - pure structural reorganization
  • Build verified: Next.js static generation succeeds for all 74 pages
  • i18n preserved: Both /en/ and /cn/ routes functional
Original prompt

docs/concepts/enterprise-framework 按照这里面的内容重新规划和整理整个文档网站


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@vercel
Copy link

vercel bot commented Jan 22, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
docs Ready Ready Preview, Comment Jan 22, 2026 5:03am

Request Review

…e-layer architecture

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
Copilot AI changed the title [WIP] Reorganize and restructure documentation site based on enterprise framework Restructure docs to align with enterprise framework three-layer architecture Jan 22, 2026
Copilot AI requested a review from hotlong January 22, 2026 05:07
@hotlong hotlong marked this pull request as ready for review January 22, 2026 05:14
Copilot AI review requested due to automatic review settings January 22, 2026 05:14
@github-actions
Copy link

🚀 Preview Deployment

This pull request will be automatically deployed to Vercel.

Preview Links

  • 📝 Documentation: Will be available once Vercel deployment completes
  • 🌍 Languages: English (/en/docs) and Chinese (/cn/docs)

Build Status

Check the CI workflow for build status and any errors.


Automated preview information for PR #53

@github-actions github-actions bot added documentation Improvements or additions to documentation i18n labels Jan 22, 2026
@hotlong hotlong merged commit c6fbb0a into main Jan 22, 2026
10 checks passed
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request restructures the ObjectStack documentation from a flat specifications/ directory to a three-layer architecture that aligns with the enterprise framework philosophy. The reorganization moves 64 specification files into Creator Layer (SDK, CLI), Governance Layer (Deployment, CI/CD), and Execution Layer (ObjectQL, ObjectOS, ObjectUI) directories.

Changes:

  • Created comprehensive layer index pages with English and Chinese versions explaining each layer's purpose and philosophy
  • Migrated all specification files from specifications/* to appropriate layer directories
  • Updated navigation metadata and cross-references throughout
  • Converted the specifications index to redirect/overview page for backward compatibility

Reviewed changes

Copilot reviewed 15 out of 64 changed files in this pull request and generated no comments.

Show a summary per file
File Description
content/docs/meta.json Added three layer directories to root navigation; fixed typo "OpenStack" → "ObjectStack"
content/docs/specifications/meta.json Simplified to redirect structure with single index page
content/docs/specifications/index.mdx Converted to overview page with links to three-layer architecture
content/docs/governance-layer/* New comprehensive governance layer documentation (CI/CD, deployment)
content/docs/execution-layer/objectql/* Migrated ObjectQL specifications with new structure
content/docs/execution-layer/objectui/* Migrated ObjectUI specifications with new structure
content/docs/execution-layer/objectos/* Migrated ObjectOS specifications with new structure

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation i18n

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants