Merge pull request #72 from objectstack-ai/copilot/fix-link-errors-in-fumadocs

Author: hotlong

.github/workflows/check-links.yml

@@ -0,0 +1,48 @@
+name: Check Links
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  link-checker:
+    name: Check Documentation Links
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Check links with lychee
+        uses: lycheeverse/lychee-action@v2
+        with:
+          # Use configuration file for path remapping and settings
+          args: >-
+            --config lychee.toml
+            'content/**/*.md'
+            'content/**/*.mdx'
+            'README.md'
+          # Fail the job if broken links are found
+          fail: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Create Issue on Failure
+        if: failure()
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: '🔗 Broken links detected in documentation',
+              body: `Link checker found broken links in the documentation.\n\nPlease review the [workflow run](${context.payload.repository.html_url}/actions/runs/${context.runId}) for details.`,
+              labels: ['documentation', 'bug']
+            });

.lycheeignore

@@ -0,0 +1,19 @@
+# Lychee Link Checker Ignore Rules
+# This file contains patterns for links that should be ignored during link checking
+
+# Local development links
+http://localhost*
+http://127.0.0.1*
+
+# Example/placeholder links
+https://example.com
+https://example.org
+http://example.com
+http://example.org
+
+# Social media (prevents anti-bot false positives)
+https://twitter.com*
+https://x.com*
+
+# Common false positives
+mailto:*

content/docs/guides/advanced/ai-integration-guide.mdx

@@ -698,7 +698,7 @@ const trainingExamples: NLQTrainingExample[] = [
 ## Example Applications
 
 ### 1. AI Support Assistant
-[View Example](../examples/ai-support)
+[View Example](/docs/guides/examples/ai-support)
 
 **Features:**
 - RAG knowledge base
@@ -712,7 +712,7 @@ Customer → GPT-4 Agent → RAG (Pinecone) → Actions → ObjectQL
 ```
 
 ### 2. AI Data Analyst
-[View Example](../examples/ai-analyst)
+[View Example](/docs/guides/examples/ai-analyst)
 
 **Features:**
 - Natural language queries
@@ -721,7 +721,7 @@ Customer → GPT-4 Agent → RAG (Pinecone) → Actions → ObjectQL
 - Query templates
 
 ### 3. AI Code Generator
-[View Example](../examples/ai-codegen)
+[View Example](/docs/guides/examples/ai-codegen)
 
 **Features:**
 - Generate ObjectStack apps
@@ -730,7 +730,7 @@ Customer → GPT-4 Agent → RAG (Pinecone) → Actions → ObjectQL
 - RAG for documentation
 
 ### 4. AI Sales Assistant
-[View Example](../examples/ai-sales)
+[View Example](/docs/guides/examples/ai-sales)
 
 **Features:**
 - Lead qualification
@@ -792,8 +792,8 @@ if (response.parseResult.confidence < 0.7) {
 ## Resources
 
 - [ObjectStack Documentation](https://docs.objectstack.ai)
-- [AI Protocol Reference](../packages/spec/src/ai)
-- [Example Applications](../examples)
+- [AI Protocol Reference](/docs/guides/packages/spec/src/ai)
+- [Example Applications](/docs/guides/examples)
 - [Discord Community](https://discord.gg/objectstack)
 
 ---

content/docs/guides/advanced/ai-integration/quick-start.mdx

@@ -166,12 +166,12 @@ const generated = await ai.generate({
 
 See the following example implementations:
 
-- [AI Sales Assistant](../../../examples/ai-sales/)
-- [AI Support Agent](../../../examples/ai-support/)
-- [AI Code Generator](../../../examples/ai-codegen/)
-- [AI Analyst](../../../examples/ai-analyst/)
+- [AI Sales Assistant](/docs/examples/ai-sales/)
+- [AI Support Agent](/docs/examples/ai-support/)
+- [AI Code Generator](/docs/examples/ai-codegen/)
+- [AI Analyst](/docs/examples/ai-analyst/)
 
-For complete documentation, see [AI_INTEGRATION_GUIDE.md](../../AI_INTEGRATION_GUIDE.md)
+For complete documentation, see [AI_INTEGRATION_GUIDE.md](/docs/guides/AI_INTEGRATION_GUIDE.md)
 
 ---
 

content/docs/guides/advanced/security/best-practices.mdx

@@ -98,7 +98,7 @@ const authConfig = {
 - [ ] Audit logging enabled
 - [ ] Regular security updates
 
-For detailed information, see [AUTHENTICATION_STANDARD.md](../../../AUTHENTICATION_STANDARD.md)
+For detailed information, see [AUTHENTICATION_STANDARD.md](/docs/AUTHENTICATION_STANDARD.md)
 
 ---
 

content/docs/guides/field-types.cn.mdx

@@ -737,7 +737,7 @@ created_at: Field.datetime({
 
 ## CRM 示例
 
-参见 **[CRM 示例](/examples/crm)** 了解所有字段类型的实际使用：
+参见 **[CRM 示例](https://github.com/objectstack-ai/spec/tree/main/examples/crm)** 了解所有字段类型的实际使用：
 
 - **账户：** 自动编号、公式、货币、带颜色的选择
 - **联系人：** 主从关系、公式（全名）、头像、电子邮件、电话

content/docs/guides/field-types.mdx

@@ -737,7 +737,7 @@ created_at: Field.datetime({
 
 ## Examples from CRM
 
-See the **[CRM Example](/examples/crm)** for real-world usage of all field types:
+See the **[CRM Example](https://github.com/objectstack-ai/spec/tree/main/examples/crm)** for real-world usage of all field types:
 
 - **Account:** Autonumber, formula, currency, select with colors
 - **Contact:** Master-detail, formula (full_name), avatar, email, phone

content/docs/guides/getting-started.cn.mdx

@@ -275,7 +275,7 @@ views: {
 
 现在你有了有效的元数据，你可以：
 
-1. **探索示例**：查看 [CRM 示例](/examples/crm) 了解完整功能实现
+1. **探索示例**：查看 [CRM 示例](https://github.com/objectstack-ai/spec/tree/main/examples/crm) 了解完整功能实现
 2. **学习字段类型**：参见 [字段类型指南](/docs/guides/field-types) 了解所有 30+ 种字段类型
 3. **构建 UI**：使用 ObjectStack 运行时的元数据来生成界面
 4. **部署**：推送到 ObjectStack 内核用于生产环境

content/docs/guides/getting-started.mdx

@@ -275,7 +275,7 @@ views: {
 
 Now that you have valid metadata, you can:
 
-1. **Explore Examples**: Check out the [CRM Example](/examples/crm) for a full-featured implementation
+1. **Explore Examples**: Check out the [CRM Example](https://github.com/objectstack-ai/spec/tree/main/examples/crm) for a full-featured implementation
 2. **Learn Field Types**: See the [Field Types Guide](/docs/guides/field-types) for all 30+ field types
 3. **Build UI**: Use the metadata with ObjectStack runtime to generate interfaces
 4. **Deploy**: Push to an ObjectStack kernel for production use

content/docs/guides/migration/v0-to-v1.mdx

@@ -145,8 +145,8 @@ The following features are deprecated and will be removed in v2.0.0:
 
 If you encounter issues:
 
-1. Check the [CHANGELOG.md](../../CHANGELOG.md)
-2. Review [CONTRIBUTING.md](../../CONTRIBUTING.md)
+1. Check the [CHANGELOG.md](/docs/CHANGELOG.md)
+2. Review [CONTRIBUTING.md](/docs/CONTRIBUTING.md)
 3. Open an issue on GitHub
 
 ---