https://github.com/openstack/training-guides
Community created, open source training guides for OpenStack. Mirror of code maintained at opendev.org.
https://github.com/openstack/training-guides
Last synced: 8 months ago
JSON representation
Community created, open source training guides for OpenStack. Mirror of code maintained at opendev.org.
- Host: GitHub
- URL: https://github.com/openstack/training-guides
- Owner: openstack
- License: apache-2.0
- Created: 2014-06-11T02:40:10.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2024-03-13T09:35:13.000Z (almost 2 years ago)
- Last Synced: 2024-08-04T06:03:05.928Z (over 1 year ago)
- Language: Shell
- Homepage: https://opendev.org/openstack/training-guides
- Size: 47.8 MB
- Stars: 86
- Watchers: 20
- Forks: 39
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
========================
Team and repository tags
========================
.. image:: https://governance.openstack.org/tc/badges/training-guides.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
.. Change things from this point on
OpenStack Training Guides
+++++++++++++++++++++++++
This repository contains open source training material that can be
used to learn about using and different ways of contributing to OpenStack
(Upstream training).
For more details, see the `OpenStack Training Guides wiki page
`_.
It includes:
* Upstream training
* Training guides (draft)
Both guides include a set of slides used in the training events.
Building
========
Various manuals are in subdirectories of the ``doc/`` directory.
Guides
------
All guides are in the RST format. You can use ``tox`` to prepare
virtual environment and build all guides::
$ tox
You can find the root of the generated HTML documentation at::
doc/upstream-training/build/slides/index.html
doc/training-guides/build/slides/index.html
Testing of changes and building of the manual
=============================================
Install the Python tox package and run ``tox`` from the top-level
directory to use the same tests that are done as part of our Jenkins
gating jobs.
If you like to run individual tests, run:
* ``tox -e publishdocs`` - to actually build all guides (used in CI
for building and publishing)
* ``tox -e upstream-slides`` - build the Upstream training
* ``tox -e training-slides`` - build the Training guides
Contributing
============
Our community welcomes all people interested in open source cloud
computing, and encourages you to join the `Open Infrastructure Foundation
`_.
The best way to get involved with the community is to talk with others
online or at a meet up and offer contributions through our processes,
the `OpenStack wiki `_, blogs, or on IRC at
``#openstack`` on ``irc.oftc.net``.
We welcome all types of contributions, from blueprint designs to
documentation to testing to deployment scripts.
If you would like to contribute to the documents, please see the
`OpenStack Documentation Contributor Guide
`_.
Bugs
====
Bugs should be filed on Launchpad, not GitHub:
https://bugs.launchpad.net/openstack-training-guides
Published guides
================
Guides are published at:
* https://docs.openstack.org/upstream-training/
Release Notes
=============
* https://docs.openstack.org/releasenotes/openstack-manuals/
Repository
==========
* https://opendev.org/openstack/training-guides