Merge "Clarify the purpose of this repository"

This commit is contained in:
Zuul 2022-03-30 18:14:58 +00:00 committed by Gerrit Code Review
commit b707997500

View File

@ -18,6 +18,15 @@ Although the act of running puppet on these hosts is managed by
Ansible, the actual core of their orchestration lives in ``manifests``
and ``modules``.
The files in this repository are provided as an opinionated example
service deployment, and to allow the OpenDev Collaboratory to use public
software development workflows in order to coordinate changes and
improvements to the systems it runs. This repository is not intended as
a reconsumable project on its own, and anyone wishing to adjust it to
suit their own needs should do so with a fork. The system-config
reviewers are unable to evaluate and support use cases for the contents
here other than their own.
Testing
-------
@ -60,7 +69,13 @@ automatically tested, reviewed by humans and, once accepted, deployed
automatically.
Bug fixes or modifications to existing code are great places to start,
and you will see the results of your changes in CI testing.
and you will see the results of your changes in CI testing. Please
remember that this repository consists of configuration and
orchestration for OpenDev Collaboratory production systems, so
contributions to it will be evaluated on the basis of whether they're
useful or applicable to OpenDev's services. Changes intended to make the
contents more easily reusable outside OpenDev itself are not in scope,
and so will be rejected by reviewers.
You can develop all the playbooks, roles, containers and testing
required for a new service just by uploading a change. Using a