From 4a7a3c940f553dcca545e0dc6ebf572c0e623d3a Mon Sep 17 00:00:00 2001 From: "Gael Chamoulaud (Strider)" Date: Wed, 23 Jun 2021 16:23:27 +0200 Subject: [PATCH] Reorganize CONTRIBUTING information This patch moves all the contributing information from doc/source/contributing.rst to CONTRIBUTING.rst file. It also removes the installation.rst because we have the same content in the readme.rst. Change-Id: I87f992918e6db67d8182a1bcc3ba2637f922bcf5 Signed-off-by: Gael Chamoulaud (Strider) --- CONTRIBUTING.rst | 63 +++++++++++++++++++++++++++++-------- README.rst | 14 ++++----- doc/source/contributing.rst | 37 ++-------------------- doc/source/index.rst | 1 - doc/source/installation.rst | 43 ------------------------- 5 files changed, 59 insertions(+), 99 deletions(-) delete mode 100644 doc/source/installation.rst diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index c6b50d3..fb406eb 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -1,19 +1,56 @@ -Contributions to validations-common follow guidelines largely similar -to those of other openstack projects. +For general information on contributing to OpenStack, please check out the +`contributor guide `_ to get started. +It covers all the basics that are common to all OpenStack projects: the accounts +you need, the basics of interacting with our Gerrit review system, how we +communicate as a community, etc. -If you're interested in contributing to the validations-libs project, -the following will help get you started: +The information below will cover the project specific information you need to get started with TripleO. - https://docs.openstack.org/infra/manual/developers.html +Documentation +============= +Documentation for the TripleO project can be found `here `_ -If you already have a good understanding of how the system works and your -OpenStack accounts are set up, you can skip to the development workflow -section of this documentation to learn how changes to OpenStack should be -submitted for review via the Gerrit tool: +Communication +============= +* IRC channel ``#validation-framework`` at `Libera`_ (For all subject-matters) +* IRC channel ``#tripleo`` at `OFTC`_ (OpenStack and TripleO discussions) +* Mailing list (prefix subjects with ``[tripleo][validations]`` for faster responses) + http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss - https://docs.openstack.org/infra/manual/developers.html#development-workflow +.. _Libera: https://libera.chat/ +.. _OFTC: https://www.oftc.net/ -Pull requests submitted through GitHub will be ignored. +Contacting the Core Team +======================== +Please refer to the `TripleO Core Team +`_ contacts. -Validations are meant to verify functionality of tripleo systems. -Therefore a special care should be given to testing your code before submitting a review. +Bug Tracking +============= +We track our tasks in `Launchpad `_ and in +`StoryBoard `_ + +Reporting a Bug +=============== +You found an issue and want to make sure we are aware of it? You can do so on +`Launchpad `__. Please, add the +validations tag to your bug. + +More info about Launchpad usage can be found on `OpenStack docs page +`_ + +Getting Your Patch Merged +========================= +All changes proposed to the TripleO requires two ``Code-Review +2`` votes from +TripleO core reviewers before one of the core reviewers can approve patch by +giving ``Workflow +1`` vote. + +Project Team Lead Duties +======================== +All common PTL duties are enumerated in the `PTL guide +`_. + +The Release Process for TripleO is documented in `Release Management +`_. + +Documentation for the TripleO project can be found `here `_ diff --git a/README.rst b/README.rst index 566d378..3f2ebe2 100644 --- a/README.rst +++ b/README.rst @@ -34,7 +34,7 @@ At the command line using `pip`. .. code-block:: console - $ pip install validations-common + $ python3 -m pip install validations-common Or, if you have virtualenvwrapper_ installed. @@ -42,17 +42,18 @@ Or, if you have virtualenvwrapper_ installed. .. code-block:: console $ mkvirtualenv validations-common - $ pip install validations-common + $ python3 -m pip install validations-common Installation with package manager --------------------------------- -Alternativelly it is possible to install validations-common using package manager. -Such as `yum`... +Alternatively it is possible to install validations-common using package manager. + +Such as `yum` or `dnf`... .. code-block:: console - $ yum install validations-common + $ yum|dnf install validations-common or the more modern `dnf`. @@ -73,9 +74,6 @@ While the validations-common can be run by itself, it nonetheless depends on Ansible and validations-libs. Therefore it isn't recommended to use only validations-common. -The validations included with validations-common are intended to be demonstrations, -capable of running on most setups. But they are not meant for production environment. - .. _virtualenvwrapper: https://pypi.org/project/virtualenvwrapper/ .. _Apache_license: http://www.apache.org/licenses/LICENSE-2.0 diff --git a/doc/source/contributing.rst b/doc/source/contributing.rst index eae6724..6e1f2b5 100644 --- a/doc/source/contributing.rst +++ b/doc/source/contributing.rst @@ -1,36 +1,5 @@ -============ -Contributing -============ +========================= +So You Want To Contribute +========================= .. include:: ../../CONTRIBUTING.rst - -Communication -------------- -* IRC channel ``#validation-framework`` at `Libera`_ (For all subject-matters) -* IRC channel ``#tripleo`` at `OFTC`_ (OpenStack and TripleO discussions) - -.. _Libera: https://libera.chat/ -.. _OFTC: https://www.oftc.net/ - -Contributor License Agreement ------------------------------ - -.. index:: - single: license; agreement - -In order to contribute to the validations-common project, you need to have -signed OpenStack's contributor's agreement. - -.. seealso:: - - * https://docs.openstack.org/infra/manual/developers.html - * https://wiki.openstack.org/wiki/CLA - -Project Hosting Details ------------------------ - -Code Hosting - https://opendev.org/openstack/validations-common - -Code Review - https://review.opendev.org/#/q/status:open+project:openstack/validations-common,n,z diff --git a/doc/source/index.rst b/doc/source/index.rst index 0970fe6..6e92628 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -12,7 +12,6 @@ Contents: :maxdepth: 2 readme - installation usage contributing roles diff --git a/doc/source/installation.rst b/doc/source/installation.rst deleted file mode 100644 index a480b3e..0000000 --- a/doc/source/installation.rst +++ /dev/null @@ -1,43 +0,0 @@ -============ -Installation -============ -Recommended process -------------------- - -There are several different ways to install validations-common. -However it is **recommended** to both install and use -the package inside python virtual environment. - -At the command line using `pip`. - -.. code-block:: console - - $ pip install validations-common - - -Or, if you have virtualenvwrapper_ installed. - -.. code-block:: console - - $ mkvirtualenv validations-common - $ pip install validations-common - -Installation with package manager ---------------------------------- -Alternativelly it is possible to install validations-common using package manager. - -Such as `yum`... - -.. code-block:: console - - $ yum install validations-common - - -or the more modern `dnf`. - -.. code-block:: console - - $ dnf install validations-common - - -.. _virtualenvwrapper: https://pypi.org/project/virtualenvwrapper/