docs/doc/source/index.rst
Kristal Dale 22f4e7843e Add nav sections/folders for config guides and admin guides
- New nav section: Configuration, topic specific config guides
- New nav section: Operation Guides, task specific guides
- New nav item: CLI Reference
- Sections organized by general, kubernetes, openstack
- Stubb pages added for all top level topics in sections, with
  link to associated StoryBoard story

Change-Id: I59f58adbb27bf4d65755cddc40a8ec565fb949f1
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-11-15 16:38:53 -08:00

80 lines
2.4 KiB
ReStructuredText
Executable File

======================================
Welcome to the StarlingX Documentation
======================================
The latest release of StarlingX is StarlingX R2.0. Additional information about
this release is available in the :ref:`release-notes`.
For more information about the StarlingX project, refer to the
`Project Specifications <specs/index.html>`__.
-------------
Documentation
-------------
The documentation is organized into the following sections:
.. toctree::
:maxdepth: 1
introduction/index
deploy_install_guides/index
configuration/index
operations/index
api-ref/index
cli_ref/index
contributor/index
releasenotes/index
developer_resources/index
--------
Projects
--------
StarlingX contains multiple sub-projects that include additional edge cloud
support services and clients. API documentation and release notes for each
project are found on the specific project page:
* `Bare Metal <metal/index.html>`__
* `Clients <clients/index.html>`__
* `Config <config/index.html>`__
* `Distributed Cloud <distcloud/index.html>`__
* `Distributed Cloud Client <distcloud-client/index.html>`__
* `Fault Management <fault/index.html>`__
* `High Availability <ha/index.html>`__
* `Horizon Plugin (GUI) <gui/index.html>`__
* `Integration <integ/index.html>`__
* `NFV <nfv/index.html>`__
* `Software Updates <update/index.html>`__
* `Upstream <upstream/index.html>`__
Supporting projects and repositories:
* `Tools <tools/index.html>`__
----------
Contribute
----------
StarlingX utilizes tooling and CI/CD environments from the OpenStack
Foundation. The source is hosted on `OpenDev's Git server`_.
.. _`OpenDev's Git server`: https://opendev.org/starlingx
Additional information regarding contributing to the project can be
found in the :ref:`StarlingX contributor guides <contribute>`.
----------
Governance
----------
StarlingX is a top-level OpenStack Foundation pilot project that is governed by
two separate bodies: The `OpenStack Foundation Board of Directors`_ and the
`StarlingX Technical Steering Committee`_.
See `StarlingX Governance`_ for additional information about StarlingX project
governance.
.. _`OpenStack Foundation Board of Directors`: https://wiki.openstack.org/wiki/Governance/Foundation
.. _`StarlingX Technical Steering Committee`: https://docs.starlingx.io/governance/reference/tsc/
.. _`StarlingX Governance`: https://docs.starlingx.io/governance/