README.md

   1 AOSC OS ABBS Tree
   2 =================
   3
   4 The AOSC OS ABBS Tree contains build configurations and scripts
   5 for all packages made available in the official AOSC OS
   6 [repository](https://repo.aosc.io), organised in a tree-like fashion. The "Tree"
   7 is split into three main classes and various sub-categories:
   8
   9 - `core-*` contains components of the [AOSC OS Core](README.CORE.md).
  10 - `app-*` contains applications.
  11 - `desktop-*` contains desktop environments and their supporting libraries.
  12 - `lang-*` contains programming language support stacks.
  13 - `meta-*` contains meta packages (`*-base`).
  14 - `runtime-*` contains runtime libraries and data.
  15
  16 Branches
  17 --------
  18
  19 The ABBS Tree is maintained in a multi-branch fashion, for more information,
  20 please refer to the [AOSC OS Maintenance Guidelines](https://wiki.aosc.io/developer/packaging/topic-based-maintenance-guideline).
  21
  22 Groups
  23 ------
  24
  25 When using [ACBS](https://github.com/AOSC-Dev/acbs/) (Autobuild CI Build System),
  26 it is possible to build a series of packages with a single command. This is
  27 achieved by the "groups" defined in the `groups/` directory, with files defining
  28 a list of packages to build.
  29
  30 Automation
  31 ----------
  32
  33 Under GitHub issues and pull requests, you may initiate package build tests via GitHub Actions, see [reference of workflows](.github/workflows/README.md) for details.
  34
  35 Further Readings
  36 ----------------
  37
  38 - [Intro to Package Maintenance](https://wiki.aosc.io/developer/packaging/basics)
  39 - [AOSC OS Package Styling Manual](https://wiki.aosc.io/developer/packaging/package-styling-manual)
  40
  41 Useful Links
  42 ------------
  43
  44 - [AOSC OS Packages](https://packages.aosc.io/)
  45 - [AOSC OS Packages, QA Information](https://packages.aosc.io/qa/)
  46     - [List of Package Issue Codes](https://wiki.aosc.io/developer/packaging/qa-issue-codes)
  47 - [AOSC Buildbot Information](https://wiki.aosc.io/developer/infrastructure/buildbots)
  48
  49 Need Help?
  50 ----------
  51
  52 Please report any build-time and run-time issues using our
  53 [issues](https://github.com/AOSC-Dev/aosc-os-abbs/issues/new/choose) page.