Revert incorrect link changes - fumadocs requires /docs/ prefix

The baseUrl: '/docs' config means docs are served at /docs routes,
so internal links MUST include /docs/ prefix to match URL structure.
My original understanding was incorrect.

- Reverted all documentation link changes to original state
- Updated validation script to correctly handle /docs/ prefix
- Removed fix-links.sh script (no longer needed)
- Updated CONTRIBUTING.md with correct link conventions
- Updated scripts/README.md with correct examples

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

CONTRIBUTING.md

@@ -426,30 +426,30 @@ pnpm site:build
 #### ✅ Correct Link Patterns
 
 ```markdown
-<!-- Correct - links start with / but do NOT include /docs/ -->
-[Quick Start](/guide/quick-start)
-[Components](/components)
-[API Reference](/reference/api/core)
-[Protocol Specs](/reference/protocol/overview)
-[Architecture](/architecture/component)
+<!-- Correct - internal documentation links MUST include /docs/ prefix -->
+[Quick Start](/docs/guide/quick-start)
+[Components](/docs/components)
+[API Reference](/docs/reference/api/core)
+[Protocol Specs](/docs/reference/protocol/overview)
+[Architecture](/docs/architecture/component)
 ```
 
 #### ❌ Incorrect Link Patterns
 
 ```markdown
-<!-- Wrong - includes /docs/ prefix -->
-[Quick Start](/docs/guide/quick-start)  <!-- ❌ -->
-[Components](/docs/components)          <!-- ❌ -->
+<!-- Wrong - missing /docs/ prefix -->
+[Quick Start](/guide/quick-start)       <!-- ❌ Should be /docs/guide/quick-start -->
+[Components](/components)               <!-- ❌ Should be /docs/components -->
 
 <!-- Wrong - incorrect paths -->
-[API Reference](/api/core)              <!-- ❌ Should be /reference/api/core -->
-[Spec](/spec/component)                 <!-- ❌ Should be /architecture/component -->
-[Protocol](/protocol/form)              <!-- ❌ Should be /reference/protocol/form -->
+[API Reference](/api/core)              <!-- ❌ Should be /docs/reference/api/core -->
+[Spec](/spec/component)                 <!-- ❌ Should be /docs/architecture/component -->
+[Protocol](/protocol/form)              <!-- ❌ Should be /docs/reference/protocol/form -->
 ```
 
 #### Why?
 
-Fumadocs already configures the base URL as `/docs` in the routing system. Adding `/docs/` to your links creates invalid paths like `/docs/docs/guide/quick-start`.
+Fumadocs is configured with `baseUrl: '/docs'`, which means all documentation pages are served under the `/docs` route. Internal links must include the `/docs/` prefix to match the actual URL structure where the pages are accessible.
 
 #### Validating Links
 
@@ -461,8 +461,8 @@ pnpm validate:links
 ```
 
 This will check:
-- Links don't contain `/docs/` prefix
 - Links point to existing files and routes
+- Links use correct path structure
 - Suggestions for fixing common issues
 
 The validation runs automatically on PRs that modify documentation files.

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](/reference/protocol/overview) for specs.
+See [Protocol Overview](/protocol/overview) for specs.
 ```
 
 ### Front Matter

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](/architecture/component-library).
+For the low-level UI component library (Button, Input, Dialog, etc.), please refer to the [Component Library Reference](component-library.md).
 
 ## 2. Base Component Categories
 

docs/components/index.md

@@ -11,28 +11,28 @@ ObjectUI provides a comprehensive set of components built on React, Tailwind CSS
 
 Browse components by category to find what you need:
 
-### [Basic Components](/components/basic/text)
+### [Basic Components](/docs/components/basic/text)
 Essential building blocks: Text, Icon, Image, Separator, HTML
 
-### [Form Components](/components/form/button)
+### [Form Components](/docs/components/form/button)
 Interactive inputs: Button, Input, Select, Checkbox, Switch, Textarea, Slider
 
-### [Layout Components](/components/layout/container)
+### [Layout Components](/docs/components/layout/container)
 Structure your UI: Container, Card, Grid, Flex, Stack, Tabs
 
-### [Data Display](/components/data-display/badge)
+### [Data Display](/docs/components/data-display/badge)
 Show information: Badge, Avatar, Alert, List
 
-### [Feedback Components](/components/feedback/loading)
+### [Feedback Components](/docs/components/feedback/loading)
 User feedback: Loading, Progress, Skeleton
 
-### [Overlay Components](/components/overlay/dialog)
+### [Overlay Components](/docs/components/overlay/dialog)
 Floating elements: Dialog, Drawer, Tooltip, Popover
 
-### [Disclosure Components](/components/disclosure/accordion)
+### [Disclosure Components](/docs/components/disclosure/accordion)
 Show/hide content: Accordion, Collapsible
 
-### [Complex Components](/components/complex/table)
+### [Complex Components](/docs/components/complex/table)
 Advanced patterns: Table (with sorting, filtering, pagination)
 
 ## Component Categories
@@ -41,73 +41,73 @@ Advanced patterns: Table (with sorting, filtering, pagination)
 
 The foundation of your UI. These are simple, single-purpose components:
 
-- **[Text](/components/basic/text)** - Display text with typography control
-- **[Icon](/components/basic/icon)** - Render icons from Lucide React
-- **[Image](/components/basic/image)** - Display images with lazy loading
-- **[Separator](/components/basic/separator)** - Visual divider between content
-- **[HTML](/components/basic/html)** - Render raw HTML content
+- **[Text](/docs/components/basic/text)** - Display text with typography control
+- **[Icon](/docs/components/basic/icon)** - Render icons from Lucide React
+- **[Image](/docs/components/basic/image)** - Display images with lazy loading
+- **[Separator](/docs/components/basic/separator)** - Visual divider between content
+- **[HTML](/docs/components/basic/html)** - Render raw HTML content
 
 ### Form Components
 
 Interactive elements for user input:
 
-- **[Button](/components/form/button)** - Trigger actions with multiple variants
-- **[Input](/components/form/input)** - Text input with validation
-- **[Select](/components/form/select)** - Dropdown selection
-- **[Checkbox](/components/form/checkbox)** - Boolean selection
-- **[Switch](/components/form/switch)** - Toggle switch
-- **[Textarea](/components/form/textarea)** - Multi-line text input
-- **[Slider](/components/form/slider)** - Numeric range selection
+- **[Button](/docs/components/form/button)** - Trigger actions with multiple variants
+- **[Input](/docs/components/form/input)** - Text input with validation
+- **[Select](/docs/components/form/select)** - Dropdown selection
+- **[Checkbox](/docs/components/form/checkbox)** - Boolean selection
+- **[Switch](/docs/components/form/switch)** - Toggle switch
+- **[Textarea](/docs/components/form/textarea)** - Multi-line text input
+- **[Slider](/docs/components/form/slider)** - Numeric range selection
 
 ### Layout Components
 
 Structure and organize your interface:
 
-- **[Container](/components/layout/container)** - Responsive container with max-width
-- **[Card](/components/layout/card)** - Content card with header and footer
-- **[Grid](/components/layout/grid)** - CSS Grid layout
-- **[Flex](/components/layout/flex)** - Flexbox layout
-- **[Stack](/components/layout/stack)** - Vertical or horizontal stack
-- **[Tabs](/components/layout/tabs)** - Tabbed interface
+- **[Container](/docs/components/layout/container)** - Responsive container with max-width
+- **[Card](/docs/components/layout/card)** - Content card with header and footer
+- **[Grid](/docs/components/layout/grid)** - CSS Grid layout
+- **[Flex](/docs/components/layout/flex)** - Flexbox layout
+- **[Stack](/docs/components/layout/stack)** - Vertical or horizontal stack
+- **[Tabs](/docs/components/layout/tabs)** - Tabbed interface
 
 ### Data Display
 
 Present data to users:
 
-- **[Badge](/components/data-display/badge)** - Small status indicators
-- **[Avatar](/components/data-display/avatar)** - User profile images
-- **[Alert](/components/data-display/alert)** - Contextual messages
-- **[List](/components/data-display/list)** - Ordered or unordered lists
+- **[Badge](/docs/components/data-display/badge)** - Small status indicators
+- **[Avatar](/docs/components/data-display/avatar)** - User profile images
+- **[Alert](/docs/components/data-display/alert)** - Contextual messages
+- **[List](/docs/components/data-display/list)** - Ordered or unordered lists
 
 ### Feedback Components
 
 Provide visual feedback:
 
-- **[Loading](/components/feedback/loading)** - Loading spinner
-- **[Progress](/components/feedback/progress)** - Progress bar
-- **[Skeleton](/components/feedback/skeleton)** - Loading placeholder
+- **[Loading](/docs/components/feedback/loading)** - Loading spinner
+- **[Progress](/docs/components/feedback/progress)** - Progress bar
+- **[Skeleton](/docs/components/feedback/skeleton)** - Loading placeholder
 
 ### Overlay Components
 
 Floating UI elements:
 
-- **[Dialog](/components/overlay/dialog)** - Modal dialog
-- **[Drawer](/components/overlay/drawer)** - Slide-out drawer
-- **[Tooltip](/components/overlay/tooltip)** - Hover tooltips
-- **[Popover](/components/overlay/popover)** - Floating popover
+- **[Dialog](/docs/components/overlay/dialog)** - Modal dialog
+- **[Drawer](/docs/components/overlay/drawer)** - Slide-out drawer
+- **[Tooltip](/docs/components/overlay/tooltip)** - Hover tooltips
+- **[Popover](/docs/components/overlay/popover)** - Floating popover
 
 ### Disclosure Components
 
 Expandable content:
 
-- **[Accordion](/components/disclosure/accordion)** - Expandable sections
-- **[Collapsible](/components/disclosure/collapsible)** - Toggle content visibility
+- **[Accordion](/docs/components/disclosure/accordion)** - Expandable sections
+- **[Collapsible](/docs/components/disclosure/collapsible)** - Toggle content visibility
 
 ### Complex Components
 
 Advanced, feature-rich components:
 
-- **[Table](/components/complex/table)** - Data table with sorting, filtering, and pagination
+- **[Table](/docs/components/complex/table)** - Data table with sorting, filtering, and pagination
 
 ## Usage Pattern
 
@@ -175,15 +175,15 @@ All ObjectUI components share these characteristics:
 
 ## Next Steps
 
-- **[Quick Start Guide](/guide/quick-start)** - Build your first ObjectUI app
-- **[Schema Rendering](/concepts/schema-rendering)** - Learn how the engine works
-- **[Component Registry](/concepts/component-registry)** - Register custom components
-- **[Expressions](/concepts/expressions)** - Dynamic values with expressions
+- **[Quick Start Guide](/docs/guide/quick-start)** - Build your first ObjectUI app
+- **[Schema Rendering](/docs/concepts/schema-rendering)** - Learn how the engine works
+- **[Component Registry](/docs/concepts/component-registry)** - Register custom components
+- **[Expressions](/docs/concepts/expressions)** - Dynamic values with expressions
 
 ## Need Help?
 
 Can't find what you're looking for? Check out:
 
-- [Concepts](/concepts) - Core concepts and architecture
-- [Advanced](/reference) - API documentation and protocol specs
+- [Concepts](/docs/concepts) - Core concepts and architecture
+- [Advanced](/docs/reference) - API documentation and protocol specs
 - [GitHub](https://github.com/objectstack-ai/objectui) - Report issues or contribute

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](/architecture/component-package) - Deep dive into component creation
+- [Creating Custom Components](/spec/component-package.md) - Deep dive into component creation
 
 ## Related Documentation
 
-- [Core API](/reference/api/core) - Component registry API
-- [React API](/reference/api/react) - React integration
-- [Component Specification](/architecture/component) - Component metadata spec
+- [Core API](/api/core) - Component registry API
+- [React API](/api/react) - React integration
+- [Component Specification](/spec/component.md) - Component metadata spec

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](/reference/protocol/overview) - Explore schema specifications
+- [Protocol Overview](/protocol/overview) - Explore schema specifications
 
 ## Related Documentation
 
-- [Core API](/reference/api/core) - Expression evaluator API
-- [Form Protocol](/reference/protocol/form) - Form-specific expressions
-- [View Protocol](/reference/protocol/view) - Data view expressions
+- [Core API](/api/core) - Expression evaluator API
+- [Form Protocol](/protocol/form) - Form-specific expressions
+- [View Protocol](/protocol/view) - Data view expressions

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](/architecture/component-package) - Component development
+- [Creating Components](/spec/component-package.md) - Component development
 
 ## Next Steps
 

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](/reference/protocol/overview) - Explore all available schemas
+- [Protocol Overview](/protocol/overview) - Explore all available schemas
 
 ## Related Documentation
 
-- [Rendering Specification](/architecture/rendering-specification) - Technical specification
-- [Architecture](/architecture) - System architecture
-- [Core API](/reference/api/core) - Core package API reference
-- [React API](/reference/api/react) - React package API reference
+- [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

docs/guide/index.md

@@ -183,9 +183,9 @@ Object UI is perfect for:
 
 Ready to get started?
 
-- [Quick Start](/guide/quick-start) - Build your first Object UI app
-- [Installation](/guide/installation) - Setup instructions
-- [Schema Rendering](/concepts/schema-rendering) - Learn the core concepts
+- [Quick Start](/docs/guide/quick-start) - Build your first Object UI app
+- [Installation](/docs/guide/installation) - Setup instructions
+- [Schema Rendering](/docs/concepts/schema-rendering) - Learn the core concepts
 
 ## Getting Help
 

docs/guide/studio.md

@@ -189,10 +189,10 @@ It is **not** designed for:
 
 ## What's Next?
 
-- [Read the full guide](/guide)
-- [Explore the API reference](/reference/api/react)
-- [Check out component specifications](/reference/protocol/overview)
-- [View the project roadmap](https://github.com/objectstack-ai/objectui)
+- [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)
 
 ## Feedback