Fix all 40 broken documentation links

Copilot · hotlong · Copilot · commit fa7ae26b48e8 · 2026-01-22T18:06:02.000Z
Fixed broken links across 14 documentation files:
- reference/protocol/overview.md (10 links)
- concepts/component-registry.md (3 links)
- concepts/expressions.md (4 links)
- concepts/schema-rendering.md (4 links)
- concepts/plugins.md (1 link)
- guide/studio.md (4 links)
- README.md (1 link)
- plugins/plugin-object.mdx (2 links)
- plugins/plugin-markdown.mdx (2 links)
- reference/protocol/crud.md (1 link)
- reference/protocol/page.md (2 links)
- migration/from-objectstack.md (1 link)
- architecture/base-components.md (1 link)
- versioning.md (2 links)

All links now use correct paths with /docs/ prefix:
- /protocol/* → /docs/reference/protocol/*
- /api/* → /docs/reference/api/*
- /spec/* → /docs/architecture/*
- External file links → GitHub URLs

Co-authored-by: hotlong &lt;50353452+hotlong@users.noreply.github.com&gt;
diff --git a/docs/README.md b/docs/README.md
@@ -213,7 +213,7 @@ Use relative links for internal documentation:
 
 ```markdown
 See [Schema Rendering](./schema-rendering.md) for details.
-See [Protocol Overview](/protocol/overview) for specs.
+See [Protocol Overview](/docs/reference/protocol/overview) for specs.
 ```
 
 ### Front Matter
diff --git a/docs/architecture/base-components.md b/docs/architecture/base-components.md
@@ -14,7 +14,7 @@ This specification defines the metadata structure for ObjectQL's built-in platfo
 - Enable marketplace distribution
 
 **Scope:** This document covers the complete metadata specification for all platform base components, including data display, data entry, layout, navigation, and visualization components.
-For the low-level UI component library (Button, Input, Dialog, etc.), please refer to the [Component Library Reference](component-library.md).
+For the low-level UI component library (Button, Input, Dialog, etc.), please refer to the [Component Library Reference](/docs/architecture/component-library).
 
 ## 2. Base Component Categories
 
diff --git a/docs/concepts/component-registry.md b/docs/concepts/component-registry.md
@@ -459,10 +459,10 @@ export { RatingComponent }
 
 - [Expression System](./expressions.md) - Learn about dynamic expressions
 - [Schema Rendering](./schema-rendering.md) - Understand the rendering engine
-- [Creating Custom Components](/spec/component-package.md) - Deep dive into component creation
+- [Creating Custom Components](/docs/architecture/component-package) - Deep dive into component creation
 
 ## Related Documentation
 
-- [Core API](/api/core) - Component registry API
-- [React API](/api/react) - React integration
-- [Component Specification](/spec/component.md) - Component metadata spec
+- [Core API](/docs/reference/api/core) - Component registry API
+- [React API](/docs/reference/api/react) - React integration
+- [Component Specification](/docs/architecture/component) - Component metadata spec
diff --git a/docs/concepts/expressions.md b/docs/concepts/expressions.md
@@ -636,10 +636,10 @@ const data: UserData = { /* ... */ }
 
 - [Schema Rendering](./schema-rendering.md) - Learn the rendering engine
 - [Component Registry](./component-registry.md) - Understand components
-- [Protocol Overview](/protocol/overview) - Explore schema specifications
+- [Protocol Overview](/docs/reference/protocol/overview) - Explore schema specifications
 
 ## Related Documentation
 
-- [Core API](/api/core) - Expression evaluator API
-- [Form Protocol](/protocol/form) - Form-specific expressions
-- [View Protocol](/protocol/view) - Data view expressions
+- [Core API](/docs/reference/api/core) - Expression evaluator API
+- [Form Protocol](/docs/reference/protocol/form) - Form-specific expressions
+- [View Protocol](/docs/reference/protocol/view) - Data view expressions
diff --git a/docs/concepts/plugins.md b/docs/concepts/plugins.md
@@ -373,7 +373,7 @@ export function registerComponents() {
 - [Component Registry](./component-registry.md) - Understanding the registry
 - [Schema Rendering](./schema-rendering.md) - How schemas become UI
 - [Lazy-Loaded Plugins Architecture](./lazy-loading.md) - Deep dive
-- [Creating Components](/spec/component-package.md) - Component development
+- [Creating Components](/docs/architecture/component-package) - Component development
 
 ## Next Steps
 
diff --git a/docs/concepts/schema-rendering.md b/docs/concepts/schema-rendering.md
@@ -411,11 +411,11 @@ Always type your schemas for better IDE support and fewer runtime errors.
 
 - [Component Registry](./component-registry.md) - Learn about component registration
 - [Expression System](./expressions.md) - Master expressions
-- [Protocol Overview](/protocol/overview) - Explore all available schemas
+- [Protocol Overview](/docs/reference/protocol/overview) - Explore all available schemas
 
 ## Related Documentation
 
-- [Schema Specification](/spec/schema-rendering) - Technical specification
-- [Architecture](/spec/architecture) - System architecture
-- [Core API](/api/core) - Core package API reference
-- [React API](/api/react) - React package API reference
+- [Rendering Specification](/docs/architecture/rendering-specification) - Technical specification
+- [Architecture](/docs/architecture) - System architecture
+- [Core API](/docs/reference/api/core) - Core package API reference
+- [React API](/docs/reference/api/react) - React package API reference
diff --git a/docs/guide/studio.md b/docs/guide/studio.md
@@ -189,10 +189,10 @@ It is **not** designed for:
 
 ## What's Next?
 
-- [Read the full guide](/docs/guide/introduction)
-- [Explore the API reference](/docs/api/react)
-- [Check out component specifications](/docs/protocol/overview)
-- [View the project roadmap](/ROADMAP)
+- [Read the full guide](/docs/guide)
+- [Explore the API reference](/docs/reference/api/react)
+- [Check out component specifications](/docs/reference/protocol/overview)
+- [View the project roadmap](https://github.com/objectstack-ai/objectui)
 
 ## Feedback
 
diff --git a/docs/migration/from-objectstack.md b/docs/migration/from-objectstack.md
@@ -148,7 +148,7 @@ The integration follows this hierarchy:
 
 If you encounter any issues:
 
-1. Check the [adapter README](packages/core/src/adapters/README.md)
+1. Check the [adapter README](https://github.com/objectstack-ai/objectui/tree/main/packages/core/src/adapters)
 2. Review the [ObjectStack spec](https://github.com/objectstack-ai/spec)
 3. Open an issue on GitHub
 
diff --git a/docs/plugins/plugin-markdown.mdx b/docs/plugins/plugin-markdown.mdx
@@ -189,7 +189,7 @@ npm install our-package
 2. Configure your settings
 3. Start building!
 
-For more information, see the [API Reference](/api).
+For more information, see the [API Reference](/docs/reference/api).
   `,
   className: 'prose prose-lg max-w-none'
 }
@@ -230,7 +230,7 @@ app.run()
 
 ## Contributing
 
-Contributions are welcome! Please read our [contributing guidelines](CONTRIBUTING.md).
+Contributions are welcome! Please read our [contributing guidelines](https://github.com/objectstack-ai/objectui/blob/main/CONTRIBUTING.md).
 
 ## License
 
diff --git a/docs/plugins/plugin-object.mdx b/docs/plugins/plugin-object.mdx
@@ -539,7 +539,7 @@ const dataSource = new ObjectQLDataSource({
 
 ## Related Documentation
 
-- [ObjectQL Integration](/docs/ecosystem/objectql.md)
-- [Data Sources](/docs/concepts/data-source.md)
+- [ObjectQL Integration](/docs/ecosystem/objectql)
+- [Data Sources](/docs/concepts/data-source)
 - [Plugin System Overview](/docs/concepts/plugins)
 - [Package README](https://github.com/objectstack-ai/objectui/tree/main/packages/plugin-object)
diff --git a/docs/reference/protocol/crud.md b/docs/reference/protocol/crud.md
@@ -497,5 +497,5 @@ See [examples/user-management](../../examples/user-management) for a complete wo
 
 - [Action Schema](./action.md)
 - [Detail Schema](./detail.md)
-- [API Integration](/ecosystem/api.md)
+- [API Integration](/docs/ecosystem/api)
 - [Event Handling](./events.md)
diff --git a/docs/reference/protocol/overview.md b/docs/reference/protocol/overview.md
@@ -10,13 +10,13 @@ The protocol is organized into several core types, each representing a different
 
 ### Core Types
 
-- **[Object](/protocol/object)** 📝 Planned - Data models and CRUD operations
-- **[View](/protocol/view)** ✅ Implemented - Data visualization (list, table, kanban, etc.)
-- **[Page](/protocol/page)** 🚧 Partial - Page layouts and structure
-- **[Form](/protocol/form)** ✅ Implemented - Form definitions and validation
-- **[Menu](/protocol/menu)** 🚧 Partial - Navigation menus and breadcrumbs
-- **[App](/protocol/app)** 📝 Planned - Application configuration
-- **[Report](/protocol/report)** 📝 Planned - Reports and analytics
+- **[Object](/docs/reference/protocol/object)** 📝 Planned - Data models and CRUD operations
+- **[View](/docs/reference/protocol/view)** ✅ Implemented - Data visualization (list, table, kanban, etc.)
+- **[Page](/docs/reference/protocol/page)** 🚧 Partial - Page layouts and structure
+- **[Form](/docs/reference/protocol/form)** ✅ Implemented - Form definitions and validation
+- **[Menu](/docs/reference/protocol/menu)** 🚧 Partial - Navigation menus and breadcrumbs
+- **[App](/docs/reference/protocol/app)** 📝 Planned - Application configuration
+- **[Report](/docs/reference/protocol/report)** 📝 Planned - Reports and analytics
 
 ## Design Principles
 
@@ -256,9 +256,9 @@ Help us improve the protocol:
 
 ## Next Steps
 
-- [Object Protocol](/protocol/object) - Learn about data models
-- [View Protocol](/protocol/view) - Understand data visualization
-- [Page Protocol](/protocol/page) - Master page layouts
+- [Object Protocol](/docs/reference/protocol/object) - Learn about data models
+- [View Protocol](/docs/reference/protocol/view) - Understand data visualization
+- [Page Protocol](/docs/reference/protocol/page) - Master page layouts
 
 ---
 
diff --git a/docs/reference/protocol/page.md b/docs/reference/protocol/page.md
@@ -486,7 +486,7 @@ The ObjectQL Studio provides a visual interface for:
 - [Application Configuration](./application.md)
 - [Form Specification](./form.md)
 - [View Specification](./view.md)
-- [Component Library](/guide/components.md)
+- [Component Library](/docs/components)
 
 ### 1.5 JSON Logic & Expressions
 
@@ -496,4 +496,4 @@ The schema supports expression evaluation for dynamic behavior, using a syntax s
 - **Ternary**: `${isAdmin ? 'Show' : 'Hide'}`
 - **Filters**: `${value | date: 'YYYY-MM-DD'}`
 
-See [Schema Rendering Specification](/community/architecture/specs/schema-rendering.md) for deeper details on the rendering engine.
+See [Schema Rendering Specification](/docs/concepts/schema-rendering) for deeper details on the rendering engine.
diff --git a/docs/versioning.md b/docs/versioning.md
@@ -67,7 +67,7 @@ All packages in the ObjectUI monorepo are versioned together:
 
 ## Changelog
 
-All changes are documented in [CHANGELOG.md](/CHANGELOG.md) following [Keep a Changelog](https://keepachangelog.com/) format.
+All changes are documented in [CHANGELOG.md](https://github.com/objectstack-ai/objectui/blob/main/CHANGELOG.md) following [Keep a Changelog](https://keepachangelog.com/) format.
 
 ### Changelog Categories
 
@@ -226,7 +226,7 @@ Features marked as "experimental" may change without notice:
 
 ### Where to Find Release Notes
 
-- [CHANGELOG.md](/CHANGELOG.md) - Detailed changes
+- [CHANGELOG.md](https://github.com/objectstack-ai/objectui/blob/main/CHANGELOG.md) - Detailed changes
 - [GitHub Releases](https://github.com/objectstack-ai/objectui/releases) - Release highlights
 - [Blog](https://blog.objectui.org) - Feature announcements
 - [Twitter](https://twitter.com/objectui) - Quick updates
