docs(kb): migrate Gitea documentation to KB system
All checks were successful
KB Lint / validate (push) Successful in 24s
All checks were successful
KB Lint / validate (push) Successful in 24s
Migrated all Gitea documentation from docs/GITEA/ folder into the Knowledge Base system, following KB naming conventions and frontmatter requirements. ## What Was Migrated ### Gitea Documentation Guides (6 KB entries) 1. **Gitea Basics Guide** () - Core concepts and features of Gitea - Key differences from GitHub - Terminology and common workflows - System requirements 2. **Gitea Actions Guide** () - Gitea Actions CI/CD system - Compatibility with GitHub Actions - Workflow creation and patterns - Troubleshooting guide 3. **LLM Guidelines for Gitea** () - Terminology guidelines for LLMs - Documentation standards - Common scenarios and checklist - Quick reference 4. **Gitea Workflows Guide** () - Common workflows (repository setup, branches, PRs, issues) - Best practices (branch naming, commits, PR process) - Integration with documentation systems - Troubleshooting 5. **Gitea API Reference** () - API authentication and endpoints - Differences from GitHub API - Common use cases - MCP server integration 6. **Gitea Documentation Overview** () - Overview and index of all Gitea documentation - Quick reference guide - Links to all Gitea KB entries ## KB System Compliance ✅ All files follow KB naming convention (YYYY-MM-DD--slug--type.md) ✅ All files have complete frontmatter (all 18 required fields) ✅ All files categorized in 02_systems/ (infrastructure/tooling) ✅ All files reference original documentation location ✅ KB changelog updated with migration entry ✅ KB index regenerated via script (8 files, 23 topics, 31 tags) ## Category Decision All Gitea documentation entries were placed in **02_systems/** category because: - Gitea is infrastructure/tooling (not project-specific) - Documentation covers platform usage and integration - Guides are system-level references - Fits KB category definition: "Infrastructure, DevOps, tooling" ## Original Documentation Original documentation remains in folder: - docs/GITEA/Gitea-Basics.md - docs/GITEA/Gitea-Actions-Guide.md - docs/GITEA/LLM-Gitea-Guidelines.md - docs/GITEA/Gitea-Workflows.md - docs/GITEA/Gitea-API-Reference.md - docs/GITEA/README.md KB entries reference original locations for full documentation. ## Benefits - Gitea documentation now searchable via KB index - Integrated with KB system for LLM discovery - Consistent with other KB entries - Maintains reference to original documentation - Provides comprehensive Gitea platform reference
This commit is contained in:
164
kb/_index.md
164
kb/_index.md
@@ -14,22 +14,86 @@ This index is automatically generated from KB file metadata. It provides searcha
|
||||
|
||||
### 02_systems
|
||||
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md) - Gitea Actions Guide (2025-11-11, howto)
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md) - Gitea API Reference (2025-11-11, howto)
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md) - Gitea Basics Guide (2025-11-11, howto)
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md) - Gitea Documentation Overview (2025-11-11, note)
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md) - LLM Guidelines for Working with Gitea (2025-11-11, howto)
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md) - Gitea Workflows Guide (2025-11-11, howto)
|
||||
- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md) - Issues Capture System Documentation (2025-11-11, note)
|
||||
|
||||
## Topics Index
|
||||
|
||||
### actions
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
|
||||
### api
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
|
||||
### automation
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
|
||||
### basics
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
|
||||
### best-practices
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
|
||||
### ci-cd
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
|
||||
### collaboration
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
|
||||
### documentation
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
|
||||
|
||||
### git
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
|
||||
### gitea
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
|
||||
|
||||
### guidelines
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
|
||||
### integration
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
|
||||
### issue-tracking
|
||||
- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
|
||||
|
||||
### kb-system
|
||||
- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
|
||||
|
||||
### llm
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
|
||||
### mcp
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
|
||||
### overview
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
|
||||
### platform
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
|
||||
### programming
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
|
||||
### terminology
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
|
||||
### testing
|
||||
- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
|
||||
|
||||
@@ -38,24 +102,105 @@ This index is automatically generated from KB file metadata. It provides searcha
|
||||
|
||||
### workflows
|
||||
- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
|
||||
## Tags Index
|
||||
|
||||
### actions
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
|
||||
### api
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
|
||||
### automation
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
|
||||
### basics
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
|
||||
### best-practices
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
|
||||
### branches
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
|
||||
### capture
|
||||
- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
|
||||
|
||||
### ci-cd
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
|
||||
### documentation
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
|
||||
|
||||
### git
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
|
||||
### gitea
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
|
||||
|
||||
### github-compatible
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
|
||||
### guide
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
|
||||
### guidelines
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
|
||||
### integration
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
|
||||
### issues
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
|
||||
|
||||
### llm
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
|
||||
### mcp
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
|
||||
### overview
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
|
||||
### platform
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
|
||||
### programming
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
|
||||
### pull-requests
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
|
||||
### reference
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
|
||||
### rest-api
|
||||
- [`02_systems/2025-11-11--gitea-api-reference--howto.md`](02_systems/2025-11-11--gitea-api-reference--howto.md)
|
||||
|
||||
### self-hosted
|
||||
- [`02_systems/2025-11-11--gitea-basics-guide--howto.md`](02_systems/2025-11-11--gitea-basics-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-documentation-overview--note.md`](02_systems/2025-11-11--gitea-documentation-overview--note.md)
|
||||
|
||||
### temporary
|
||||
- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
|
||||
|
||||
### terminology
|
||||
- [`02_systems/2025-11-11--gitea-llm-guidelines--howto.md`](02_systems/2025-11-11--gitea-llm-guidelines--howto.md)
|
||||
|
||||
### test
|
||||
- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
|
||||
|
||||
@@ -66,13 +211,22 @@ This index is automatically generated from KB file metadata. It provides searcha
|
||||
- [`01_projects/tendril/2025-11-11--test-kb-workflow--note.md`](01_projects/tendril/2025-11-11--test-kb-workflow--note.md)
|
||||
- [`02_systems/2025-11-11--issues-capture-system--note.md`](02_systems/2025-11-11--issues-capture-system--note.md)
|
||||
|
||||
### workflows
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
- [`02_systems/2025-11-11--gitea-workflows-guide--howto.md`](02_systems/2025-11-11--gitea-workflows-guide--howto.md)
|
||||
|
||||
## Phase Relevance Index
|
||||
|
||||
### phase-03
|
||||
- [`02_systems/2025-11-11--gitea-actions-guide--howto.md`](02_systems/2025-11-11--gitea-actions-guide--howto.md)
|
||||
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
||||
- **Total KB Files**: 2
|
||||
- **Unique Topics**: 7
|
||||
- **Unique Tags**: 8
|
||||
- **Phases Referenced**: 0
|
||||
- **Total KB Files**: 8
|
||||
- **Unique Topics**: 23
|
||||
- **Unique Tags**: 31
|
||||
- **Phases Referenced**: 1
|
||||
|
||||
_Index generated on 2025-11-11 12:30:43_
|
||||
_Index generated on 2025-11-11 12:35:45_
|
||||
|
||||
Reference in New Issue
Block a user