OpenDev Manual
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Zuul 7d7155d790 Merge "Restore Zuul v3 Migration Guide bits on secrets" 5 months ago
doc/source Merge "Restore Zuul v3 Migration Guide bits on secrets" 5 months ago
.gitignore Add ChangeLog and AUTHORS to .gitignore 5 years ago
.gitreview Update .gitreview after rename 11 months ago
LICENSE Initial commit 6 years ago
README.rst Rework README.rst for OpenDev 11 months ago
requirements.txt Use alabaster theme 11 months ago
setup.cfg Update contact info for OpenDev community 10 months ago
setup.py Update python files for OpenDev 11 months ago
tox.ini Update infra-specs URL 1 year ago

README.rst

OpenDev Manual

To build the manual, execute the following command:

$ tox

After running tox, the documentation will be available for viewing in HTML format in the doc/build/ directory.

Terminology

A note on terminology use in the manual:

This manual is in service of OpenDev, but does so primarily by documenting how developers and project drivers can use the infrastructure to accomplish their work.

We strive for consistent terminology that matches what developers and our tooling use, even if some hosted projects use different terminology.

Generally speaking these terms should be used as follows:

Project: The overall idea that there is a bunch of people working on a bunch of code/text/etc. It can also refer to that actual collection of code/text/etc (for instance, a project can be bundled up into a tarball, and extracted into a directory). When a tool interacts with that collection of code/text/etc, it interacts with the project (even if it does so via the mechanism of git).

Repository: There are times when one needs to refer to the actual source code management system of a project, that is, "git", and the actual technical implementations of that SCM. In those cases where it is important to distinguish the actual attributes of the SCM from the project, it is useful to use the word "repository".