Files
tendril/kb/02_systems/2025-11-11--gitea-basics-guide--howto.md
Gitea Actions 5b8bf62130
All checks were successful
KB Lint / validate (push) Successful in 24s
docs(kb): migrate Gitea documentation to KB system
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
2025-11-11 12:36:12 -07:00

3.8 KiB

title, date, captured_at, author, source, source_type, project, related_projects, topics, tags, type, status, phase_relevance, routing_hint, proposed_path, routing_confidence, related, summary, key_takeaways, action_candidates
title date captured_at author source source_type project related_projects topics tags type status phase_relevance routing_hint proposed_path routing_confidence related summary key_takeaways action_candidates
Gitea Basics Guide 2025-11-11 2025-11-11
datawarrior
kind ref
doc docs/GITEA/Gitea-Basics.md
personal_note
tendril
tendril
gitea
platform
basics
documentation
gitea
basics
guide
platform
self-hosted
documentation
howto active
Gitea platform basics guide - infrastructure/tooling documentation kb/02_systems/ 0.95
docs/GITEA/Gitea-Basics.md
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.

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


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