---
title: "Gitea Documentation Overview"
date: "2025-11-11"
captured_at: "2025-11-11"
author: ["datawarrior"]
source: { kind: doc, ref: "docs/GITEA/README.md" }
source_type: personal_note
project: ["tendril"]
related_projects: ["tendril"]
topics: ["gitea", "documentation", "overview", "platform"]
tags: ["gitea", "documentation", "overview", "platform", "self-hosted", "reference"]
type: note
status: active
phase_relevance: []
routing_hint: "Gitea documentation overview and index - infrastructure/tooling documentation"
proposed_path: "kb/02_systems/"
routing_confidence: 0.95
related: ["docs/GITEA/README.md"]
summary: "Overview of Gitea documentation directory. Provides quick reference for Gitea platform basics, Actions, workflows, API, and LLM guidelines. Index to all Gitea-related documentation."
key_takeaways: []
action_candidates: []
---

# Gitea Documentation Overview

## Purpose

This directory contains documentation to help AI assistants (LLMs) understand and work with Gitea, a self-hosted Git service.

## What is Gitea?

**Gitea** is a painless, self-hosted, all-in-one software development service. It includes Git hosting, code review, team collaboration, package registry, and CI/CD. It is similar to GitHub, Bitbucket and GitLab.

**Key Reference**: [Gitea Official Documentation](https://docs.gitea.com/)

## Documentation Contents

### Core Guides

- **[Gitea-Basics.md](./Gitea-Basics.md)** - Core concepts, features, and how Gitea differs from GitHub
- **[Gitea-Actions-Guide.md](./Gitea-Actions-Guide.md)** - Gitea Actions (CI/CD) compatibility and usage
- **[Gitea-Workflows.md](./Gitea-Workflows.md)** - Common workflows and best practices
- **[Gitea-API-Reference.md](./Gitea-API-Reference.md)** - API differences and considerations
- **[LLM-Gitea-Guidelines.md](./LLM-Gitea-Guidelines.md)** - Guidelines for LLMs working with Gitea

## Quick Reference

### What is Gitea?

Gitea is a self-hosted Git service that provides:
- Git hosting and repository management
- Code review (Pull Requests and AGit workflow)
- Issue tracking and project management
- CI/CD via Gitea Actions (compatible with GitHub Actions)
- Package registry (20+ package types)
- Team collaboration tools

### Key Differences from GitHub

1. **Self-Hosted**: Gitea runs on your own infrastructure
2. **Lightweight**: Designed to be fast and resource-efficient
3. **Open Source**: MIT licensed, community-driven
4. **Actions Compatibility**: Gitea Actions uses the same YAML format as GitHub Actions
5. **API Compatibility**: Gitea API is similar to GitHub's but has some differences

### Gitea Actions Compatibility

**Critical**: Gitea Actions is compatible with GitHub Actions:
- Same `.github/workflows/` directory structure
- Same YAML workflow format
- Same triggers and syntax
- Existing GitHub Actions workflows work with minimal or no modifications
- Actions plugins can be downloaded from any Git website

**Reference**: [Gitea Actions Documentation](https://docs.gitea.com/usage/actions/)

## For LLMs Working with Gitea

### Terminology

- Use **"Gitea"** (not "GitHub") when referring to the platform
- Use **"Gitea Actions"** (not "GitHub Actions") but note compatibility
- Use **"Pull Request"** or **"PR"** (same as GitHub)
- Use **"Issues"** (same as GitHub)
- Use **"Repository"** or **"Repo"** (same as GitHub)

### Documentation References

When creating documentation:
- Reference Gitea-specific features when relevant
- Note GitHub Actions compatibility when discussing workflows
- Use Gitea terminology consistently
- Link to Gitea documentation: `https://docs.gitea.com/`

### Workflow Files

- Workflows use `.github/workflows/` directory (same as GitHub)
- YAML format is identical to GitHub Actions
- Reference as "Gitea Actions workflows" in documentation
- Note compatibility: "Gitea Actions is compatible with GitHub Actions"

## Repository Context

**Tendril Repository**: https://git.parkingmeter.info/Mycelium/tendril  
**Gitea Instance**: Self-hosted at git.parkingmeter.info  
**Primary Platform**: Gitea (not GitHub)

## Additional Resources

- **Official Gitea Docs**: https://docs.gitea.com/
- **Gitea Actions**: https://docs.gitea.com/usage/actions/
- **Gitea API**: https://docs.gitea.com/api/
- **Gitea Source**: https://gitea.com/gitea/gitea

## KB Entries

All Gitea documentation has been migrated to KB system:

- `kb/02_systems/2025-11-11--gitea-basics-guide--howto.md` - Gitea basics
- `kb/02_systems/2025-11-11--gitea-actions-guide--howto.md` - Gitea Actions
- `kb/02_systems/2025-11-11--gitea-llm-guidelines--howto.md` - LLM guidelines
- `kb/02_systems/2025-11-11--gitea-workflows-guide--howto.md` - Workflows
- `kb/02_systems/2025-11-11--gitea-api-reference--howto.md` - API reference
- `kb/02_systems/2025-11-11--gitea-documentation-overview--note.md` - This overview

---

**Original Location**: `docs/GITEA/README.md`  
**Last Updated**: 2025-01-27  
**Related**: 
- All Gitea documentation files in `docs/GITEA/`
- All Gitea KB entries in `kb/02_systems/`