doc: add sample repository directory; repo layout documentation

This commit is contained in:
2025-07-07 13:57:47 +01:00
parent ba40290eea
commit 3076555b04
7 changed files with 132 additions and 0 deletions

10
doc/repo-format.txt Normal file
View File

@@ -0,0 +1,10 @@
Root directory contents:
- index.json: Describes the repository, including it's name, description, available channels, the system for which it provides packages, etc.
- news: Contains news items. The latest news will be shown to the user when they next refresh their package database.
- pool: Contains all the raw package files. If multiple channels provide the same package version/arch, both will point to the same package file within the pool.
- channel: The channels that this repository provides.
/pool directory contents:
- One directory for each letter of the alphabet, plus an extra set of directories for each letter of the alphabet prefixed with 'lib'.
When a package is added to the repository, it is stored in one of these subdirectories. Which one depends on the first letter of the package name.