diff options
| author | Radosław Piliszek <radoslaw.piliszek@gmail.com> | 2020-09-17 18:36:47 +0200 |
|---|---|---|
| committer | Radosław Piliszek <radoslaw.piliszek@gmail.com> | 2021-03-17 10:14:51 +0000 |
| commit | d9efe9cac63e6916d1012e39ec0912e9693e7c52 (patch) | |
| tree | 2d9fa2b22c95302bbf610b6704614fd247945b1d /doc/source/contributor | |
| parent | be544f4e66a6d0dbaa0c26e4565ccfe6a2548838 (diff) | |
| download | kolla-d9efe9cac63e6916d1012e39ec0912e9693e7c52.tar.gz kolla-d9efe9cac63e6916d1012e39ec0912e9693e7c52.zip | |
Improve docs
Part of changes discussed during Kolla Kalls.
These make our documentation easier to digest.
Changes in conf.py are to avoid warnings from sphinx.
Change-Id: I76ab6786b271963252278fcf12f1a28cab520fdb
Diffstat (limited to 'doc/source/contributor')
| -rw-r--r-- | doc/source/contributor/genconfig.rst | 18 | ||||
| -rw-r--r-- | doc/source/contributor/index.rst | 2 | ||||
| -rw-r--r-- | doc/source/contributor/running-in-development.rst | 29 |
3 files changed, 49 insertions, 0 deletions
diff --git a/doc/source/contributor/genconfig.rst b/doc/source/contributor/genconfig.rst new file mode 100644 index 000000000..e026dd1e1 --- /dev/null +++ b/doc/source/contributor/genconfig.rst @@ -0,0 +1,18 @@ +=========================== +Generating kolla-build.conf +=========================== + +Install tox and generate the build configuration. The build configuration is +designed to hold advanced customizations when building images. + +If you have already cloned the Kolla Git repository to the ``kolla`` folder, +generate the ``kolla-build.conf`` file using the following steps. + +.. code-block:: console + + python3 -m pip install tox + cd kolla/ + tox -e genconfig + +The location of the generated configuration file is +``etc/kolla/kolla-build.conf``. diff --git a/doc/source/contributor/index.rst b/doc/source/contributor/index.rst index bec582049..f8725fab1 100644 --- a/doc/source/contributor/index.rst +++ b/doc/source/contributor/index.rst @@ -13,7 +13,9 @@ We welcome everyone to join our project! :maxdepth: 2 contributing + running-in-development adding-a-new-image + genconfig release-notes running-tests code-reviews diff --git a/doc/source/contributor/running-in-development.rst b/doc/source/contributor/running-in-development.rst new file mode 100644 index 000000000..4645b48ed --- /dev/null +++ b/doc/source/contributor/running-in-development.rst @@ -0,0 +1,29 @@ +.. _running-in-development: + +================================== +Running Kolla Build in development +================================== + +The recommended way to run in development +----------------------------------------- + +The preferred way to run kolla-build for development is using ``tox``. +Run the following from inside the repository: + +.. code-block:: console + + tox -e venv -- kolla-build ... + +The alternative way to run in development +----------------------------------------- + +Sometimes, developers prefer to manage their venvs themselves. This is also +possible. Remember to install in editable mode (``-e``). Run the following from +inside the repository: + +.. code-block:: console + + python3 -m venv ~/path/to/venv + source ~/path/to/venv/bin/activate + python3 -m pip install -e . + kolla-build ... |