Fix broken documentation links and add missing example code

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

Author: Copilot

docs/api/attachments.md

@@ -1236,7 +1236,7 @@ Configure file storage behavior using environment variables:
 ## Related Documentation
 
 - [Object Definition Specification](../spec/object.md) - Field type definitions
-- [API Reference](./README.md) - Complete API documentation
+- [API Reference](./index.md) - Complete API documentation
 - [Validation Rules](../spec/validation.md) - File validation configuration
 - [Server Integration](../guide/server-integration.md) - Setting up file storage
 

docs/api/graphql.md

@@ -938,7 +938,7 @@ mutation DeleteUser($id: String!) {
 
 - [GraphQL Specification](https://spec.graphql.org/)
 - [ObjectQL Query Language](../spec/query-language.md)
-- [REST API Documentation](./README.md#rest-style-api)
+- [REST API Documentation](./index.md)
 - [Authentication Guide](./authentication.md)
 
 ---

docs/api/quick-reference.md

@@ -484,10 +484,10 @@ GET /api/metadata/objects/orders/actions
 
 ## Next Steps
 
-- [Complete API Reference](./README.md)
+- [Complete API Reference](./index.md)
 - [Authentication Guide](./authentication.md)
 - [Query Language Spec](../spec/query-language.md)
-- [Examples](./README.md#examples)
+- [Examples](./examples.md)
 
 ---
 

docs/contributing.md

@@ -189,7 +189,7 @@ Then create a pull request on GitHub.
 
 ### 🔌 New Drivers
 
-See the [Driver Extensibility Guide](./docs/guide/drivers/extensibility.md) for detailed instructions.
+See the [Driver Extensibility Guide](./guide/drivers/extensibility.md) for detailed instructions.
 
 Quick steps:
 1. Create a new package in `packages/drivers/`
@@ -437,7 +437,7 @@ Description of the function.
 
 ## See Also
 
-- [Related Feature](./related-feature.md)
+- Related Feature (link to specific feature documentation as needed)
 - [API Reference](/api/)
 ````
 

docs/development-plan.md

@@ -396,7 +396,7 @@ We welcome community contributions in the following areas:
 - **Examples** - Sample applications
 - **Bug Fixes** - Issue resolution
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+See [Contributing Guide](./contributing.md) for guidelines.
 
 ---
 
@@ -538,10 +538,10 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
 
 ### Related Documents
 
-- [ROADMAP.md](./ROADMAP.md) - Long-term vision and milestones
-- [CONTRIBUTING.md](./CONTRIBUTING.md) - Contribution guidelines
-- [ARCHITECTURE.md](./docs/guide/architecture/overview.md) - System architecture
-- [CHANGELOG.md](./CHANGELOG.md) - Version history
+- [Roadmap](./roadmap.md) - Long-term vision and milestones
+- [Contributing Guide](./contributing.md) - Contribution guidelines
+- [Architecture Overview](./guide/architecture/overview.md) - System architecture
+- [GitHub Releases](https://github.com/objectstack-ai/objectql/releases) - Version history
 
 ### References
 

docs/project-status.md

@@ -242,7 +242,7 @@ ObjectQL is a universal data compiler that transforms declarative YAML metadata
 - [ ] Complete audit system
 - [ ] Performance optimization
 
-See [ROADMAP.md](./ROADMAP.md) for complete roadmap.
+See [Roadmap](./roadmap.md) for complete roadmap.
 
 ---
 
@@ -350,16 +350,16 @@ See [ROADMAP.md](./ROADMAP.md) for complete roadmap.
 
 We welcome contributions! See:
 
-- [CONTRIBUTING.md](./CONTRIBUTING.md) - Contribution guidelines
-- [DEVELOPMENT_PLAN.md](./DEVELOPMENT_PLAN.md) - Detailed development plan
+- [Contributing Guide](./contributing.md) - Contribution guidelines
+- [Development Plan](./development-plan.md) - Detailed development plan
 - [GitHub Issues](https://github.com/objectstack-ai/objectql/issues) - Open issues
 
 ---
 
 ## License
 
-ObjectQL is released under the PolyForm Shield License 1.0.0. See [LICENSE](./LICENSE) for details.
+ObjectQL is released under the PolyForm Shield License 1.0.0. See [LICENSE](../LICENSE) for details.
 
 ---
 
-*This status document is updated monthly. For real-time updates, see the [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/objectstack-ai/objectql/releases).*
+*This status document is updated monthly. For real-time updates, see [GitHub Releases](https://github.com/objectstack-ai/objectql/releases).*

docs/roadmap.md

@@ -303,7 +303,7 @@ ObjectQL aims to be the **Standard Protocol for AI Software Generation** - a uni
 This roadmap represents the core team's priorities, but we welcome community input:
 
 1. **Feature Requests** - Open an issue with the `enhancement` label
-2. **Driver Contributions** - See [Driver Extensibility Guide](./docs/guide/drivers/extensibility.md)
+2. **Driver Contributions** - See [Driver Extensibility Guide](./guide/drivers/extensibility.md)
 3. **Documentation** - Submit PRs to improve guides and examples
 4. **Testing** - Help increase test coverage and report bugs
 

docs/schema-introspection.md

@@ -260,9 +260,62 @@ Convert introspected schema to ObjectQL object configurations.
 
 **Returns:** `ObjectConfig[]` - Array of object configurations
 
-## Examples
+## Complete Example
 
-See [examples/connect-existing-database.ts](../examples/connect-existing-database.ts) for a complete working example.
+Here's a complete working example combining all features:
+
+```typescript
+import { ObjectQL } from '@objectql/core';
+import { SqlDriver } from '@objectql/driver-sql';
+import * as fs from 'fs';
+import * as yaml from 'js-yaml';
+
+async function connectExistingDatabase() {
+    // Create driver for existing database
+    const driver = new SqlDriver({
+        client: 'postgresql',
+        connection: {
+            host: 'localhost',
+            database: 'my_existing_db',
+            user: 'username',
+            password: 'password'
+        }
+    });
+
+    // Initialize ObjectQL
+    const app = new ObjectQL({
+        datasources: { default: driver }
+    });
+
+    // Introspect and register all tables
+    const objects = await app.introspectAndRegister('default', {
+        excludeTables: ['migrations', 'schema_version']
+    });
+
+    console.log(`Discovered ${objects.length} tables`);
+
+    // Initialize and use
+    await app.init();
+    const ctx = app.createContext({ isSystem: true });
+
+    // Query existing data
+    const users = await ctx.object('users').find({
+        top: 10
+    });
+
+    console.log('Users:', users);
+
+    // Optionally export metadata to files
+    objects.forEach(obj => {
+        fs.writeFileSync(
+            `src/objects/${obj.name}.object.yml`,
+            yaml.dump(obj)
+        );
+    });
+}
+
+connectExistingDatabase().catch(console.error);
+```
 
 ## Chinese Documentation (中文文档)
 

docs/spec/index.md

@@ -4,7 +4,7 @@ Complete metadata specifications for the ObjectQL platform. ObjectQL is a metada
 
 📖 **[Read the Complete Metadata Standard Guide](./metadata-standard.md)** - A comprehensive overview of the entire metadata system and how all pieces fit together.
 
-📊 **[Implementation Progress Report](../../PROGRESS.md)** - Current implementation status of all specifications (v1.8.4 - 70% complete)
+📊 **[Implementation Progress Report](../project-status.md)** - Current implementation status of all specifications
 
 ## Core Data Layer