OpenStack Operations Guide
Go to file
OpenStack Proposal Bot 2ecacaa2cf Imported Translations from Zanata
For more information about this automatic import see:
https://docs.openstack.org/i18n/latest/reviewing-translation-import.html

Change-Id: Ifdc5f056a628a1f2605fdc96bf8c3324886daa9b
2018-12-21 07:20:56 +00:00
doc Imported Translations from Zanata 2018-12-21 07:20:56 +00:00
.gitignore Add '*.pyc' in gitignore 2018-08-10 09:34:34 +00:00
.gitreview Restore operations-guide content 2018-06-28 10:52:46 -05:00
.zuul.yaml Revert "add translation job" 2018-11-02 15:37:26 +00:00
LICENSE Restore operations-guide content 2018-06-28 10:52:46 -05:00
README.rst Update docs URL 2018-11-16 06:30:22 +01:00
setup.cfg Add translated docs building 2018-12-06 22:04:40 +01:00
tox.ini Add translated docs building 2018-12-06 22:04:40 +01:00

README.rst

OpenStack Operations Guide

This repository contains the source files for the OpenStack Operations Guide.

You can read this guide at docs.openstack.org/operations-guide.

Prerequisites

At a minimum, you will need git and the git-review tool installed in order to contribute documentation. You will also need a Gerrit account to submit the change.

Git is available for Linux, Mac, and Windows environements. Some platforms come with it preinstalled, but you can review the installation instructions if you do not have it by default.

Once git is installed, you can follow the instructions for your platform to install git-review.

The last step is to configure git with your name and email address used for your Gerrit account set up so it can link you patch to your user. Run the following to set these values:

git config --global user.name "First Last"
git config --global user.email "your_email@youremail.com"

Submitting Updates

Proposing updates to the documentation is fairly straight forward once you've done it, but there are a few steps that can appear intimidating your first couple times through. Here is a suggested workflow to help you along the way.

git clone https://git.openstack.org/openstack/operations-guide
cd operations-guide

# it is useful to make changes on a separate branch in case you need to make
# other changes
git checkout -b my-topic

# edit your files
git add .
git commit # Add a descriptive commit message

# submit your changes for review
git review

The changes will then be run through a few tests to make sure the docs build and it will be ready for reviews. Once reviewed, if no problems are found with the changes they will be merged to the repo and the changes will be published to the docs.openstack.org site.

Local Testing

If you would like to build the docs locally to make sure there are no issues with the changes, and to view locally generated HTML files, you will need to do a couple extra steps.

The jobs are run using a tool called tox. You will need to install tox on your platform first following its installation guide.

You can then run the following to perform a local build with some tests:

tox -e docs

If you have any questions, please reach out on the #openstack-operators IRC channel or through the openstack-ops mailing list.