diff --git a/developer_manual/release-process.rst b/developer_manual/release-process.rst index f7ea330..f182bd1 100644 --- a/developer_manual/release-process.rst +++ b/developer_manual/release-process.rst @@ -27,6 +27,7 @@ There are only two semantic human release gates: merging the generated release P .. toctree:: :maxdepth: 2 + release-process/reusable-tooling release-process/configuration release-process/preparing release-process/versioning diff --git a/developer_manual/release-process/reusable-tooling.rst b/developer_manual/release-process/reusable-tooling.rst new file mode 100644 index 0000000..515125a --- /dev/null +++ b/developer_manual/release-process/reusable-tooling.rst @@ -0,0 +1,46 @@ +.. SPDX-FileCopyrightText: 2026 LibreCode coop and contributors +.. SPDX-License-Identifier: AGPL-3.0-or-later + +Reusable release tooling +======================== + +LibreSign is the reference consumer of LibreCode's reusable release tooling. +The reusable pieces are intentionally independent of LibreSign application +code. + +``LibreCodeCoop/release-tool`` + Owns release policy, contracts, the PHP/PHAR runtime, release planning, + changelog/version transitions, draft creation, publication verification and + the public lifecycle Actions. + +``LibreCodeCoop/.github`` + Owns the organization workflow catalog, managed workflow distribution, + synchronization helpers and organization-level automation. + +``LibreSign/libresign`` + Supplies the consumer configuration, stable branches, changelog/version + files, repository-specific packaging rules and publisher workflow. + +The former ``LibreCodeCoop/github-workflows`` repository is retired and should +not be used by new consumers. + +Adopting the tooling in another app +----------------------------------- + +Start with the generic guides maintained next to Release Tool: + +* `Getting started `_ +* `Consumer configuration `_ +* `Release lifecycle `_ +* `GitHub Actions integration `_ +* `GitHub App setup `_ +* `Troubleshooting `_ + +Managed workflow catalog and synchronization documentation belongs to +``LibreCodeCoop/.github``. Consumer repositories should use the current +organization catalog rather than copying orchestration from the retired +``github-workflows`` repository. + +The remaining pages in this section describe LibreSign's concrete release +process. Generic Release Tool configuration should stay canonical in the +Release Tool repository instead of being duplicated here.