5b8bf62130
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
111 lines
3.8 KiB
Markdown
111 lines
3.8 KiB
Markdown
---
|
|
title: "Gitea Basics Guide"
|
|
date: "2025-11-11"
|
|
captured_at: "2025-11-11"
|
|
author: ["datawarrior"]
|
|
source: { kind: doc, ref: "docs/GITEA/Gitea-Basics.md" }
|
|
source_type: personal_note
|
|
project: ["tendril"]
|
|
related_projects: ["tendril"]
|
|
topics: ["gitea", "platform", "basics", "documentation"]
|
|
tags: ["gitea", "basics", "guide", "platform", "self-hosted", "documentation"]
|
|
type: howto
|
|
status: active
|
|
phase_relevance: []
|
|
routing_hint: "Gitea platform basics guide - infrastructure/tooling documentation"
|
|
proposed_path: "kb/02_systems/"
|
|
routing_confidence: 0.95
|
|
related: ["docs/GITEA/Gitea-Basics.md"]
|
|
summary: "Comprehensive guide to Gitea platform basics including core concepts, features, differences from GitHub, terminology, and common workflows. Reference documentation for LLMs working with Gitea-based projects."
|
|
key_takeaways: []
|
|
action_candidates: []
|
|
---
|
|
|
|
# Gitea Basics Guide
|
|
|
|
## Overview
|
|
|
|
**Gitea** is a painless, self-hosted, all-in-one software development service. It includes Git hosting, code review, issue tracking, CI/CD, package registry, and team collaboration tools.
|
|
|
|
**Key Point**: Gitea is similar to GitHub, Bitbucket, and GitLab, but is designed to be lightweight and self-hosted.
|
|
|
|
## Core Features
|
|
|
|
1. **Code Hosting** - Repository management, commit history, code browsing
|
|
2. **Code Review** - Pull Request workflow (same as GitHub) and AGit workflow (Gitea-specific)
|
|
3. **Issue Tracking** - Requirements, features, bugs with assignments, milestones, dependencies
|
|
4. **CI/CD** - Gitea Actions (compatible with GitHub Actions)
|
|
5. **Package Registry** - 20+ package types (Cargo, npm, PyPI, Maven, etc.)
|
|
6. **Security** - User permissions, ACLs, security-focused design
|
|
|
|
## Key Differences from GitHub
|
|
|
|
1. **Self-Hosted** - Runs on your own infrastructure
|
|
2. **Lightweight** - Fast and resource-efficient
|
|
3. **Open Source** - MIT licensed, community-driven
|
|
4. **Actions Compatibility** - Same format as GitHub Actions
|
|
5. **API Differences** - Similar but not identical to GitHub's API
|
|
|
|
## Terminology
|
|
|
|
### Same as GitHub
|
|
- Repository/Repo, Branch, Pull Request/PR, Issue, Commit, Tag, Fork, Clone
|
|
|
|
### Gitea-Specific
|
|
- **AGit workflow** - Alternative to Pull Request workflow
|
|
- **Gitea Actions** - CI/CD system (compatible with GitHub Actions)
|
|
- **Self-hosted** - Running on your own infrastructure
|
|
|
|
## Common Workflows
|
|
|
|
### Creating a Repository
|
|
1. Log in to Gitea instance
|
|
2. Click "New Repository"
|
|
3. Configure settings
|
|
4. Push code or initialize with README
|
|
|
|
### Creating a Pull Request
|
|
1. Create a branch
|
|
2. Make changes and commit
|
|
3. Push branch to Gitea
|
|
4. Click "New Pull Request"
|
|
5. Review and merge (same as GitHub)
|
|
|
|
### Using Gitea Actions
|
|
1. Create `.github/workflows/` directory
|
|
2. Write workflow YAML (same format as GitHub Actions)
|
|
3. Push to repository
|
|
4. Gitea Actions will execute workflows
|
|
|
|
## For LLMs: Important Notes
|
|
|
|
- Always refer to "Gitea" (not "GitHub") when the platform is Gitea
|
|
- Note that Gitea Actions is compatible with GitHub Actions
|
|
- Use Gitea terminology consistently
|
|
- Link to Gitea documentation: `https://docs.gitea.com/`
|
|
|
|
## System Requirements
|
|
|
|
- **Minimum**: Raspberry Pi 3 (for small workloads)
|
|
- **Typical**: 2 CPU cores, 1GB RAM (for small teams/projects)
|
|
- **Git**: Version 2.0.0 or later required
|
|
- **Platforms**: Linux, macOS, Windows (x86, amd64, ARM, PowerPC)
|
|
|
|
## References
|
|
|
|
- **Gitea Documentation**: https://docs.gitea.com/
|
|
- **Gitea Features**: https://docs.gitea.com/installation/comparison#general-features
|
|
- **Gitea Actions**: https://docs.gitea.com/usage/actions/
|
|
- **Gitea API**: https://docs.gitea.com/api/
|
|
|
|
---
|
|
|
|
**Original Location**: `docs/GITEA/Gitea-Basics.md`
|
|
**Last Updated**: 2025-01-27
|
|
**Related**:
|
|
- `docs/GITEA/Gitea-Actions-Guide.md`
|
|
- `docs/GITEA/Gitea-Workflows.md`
|
|
- `docs/GITEA/LLM-Gitea-Guidelines.md`
|
|
- `docs/GITEA/Gitea-API-Reference.md`
|
|
|