Kristal Dale 5ce4e885ea Initial setup for R3 docs
- Copy R2 docs into R3 (as base) and update release number
- Remove unused labels from R2 (resolve conflict w/ copy)
- Add note to users re R3 release status and contributing (on
  the R3 install guides landing page)

Change-Id: Ib3d3138e93a20d11e89e7eae7bc2885c8c0b90c8
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-10-07 14:57:54 -07:00

72 lines
2.2 KiB
ReStructuredText
Executable File

==================================
Installation and Deployment Guides
==================================
Installation and deployment guides for StarlingX are release-specific.
Each guide provides instruction on a specific StarlingX configuration
(e.g. All-in-one Simplex).
-----------------------
Latest release (stable)
-----------------------
StarlingX R2.0 is the latest officially released version of StarlingX.
.. toctree::
:maxdepth: 1
r2_release/index
---------------------
Upcoming R3.0 release
---------------------
StarlingX R3.0 is the forthcoming version of StarlingX under development.
.. toctree::
:maxdepth: 1
r3_release/index
-----------------
Archived releases
-----------------
.. toctree::
:maxdepth: 1
r1_release/index
.. Add common files to toctree
.. toctree::
:maxdepth: 1
:hidden:
bootable_usb
.. Making a new release
.. 1. Archive the previous 'latest' release.
Move the toctree link from the Latest release section into the Archived
releases toctree.
.. 2. Make the previous 'upcoming' release the new 'latest.'
Move the toctree link from the Upcoming release section into the Latest
release. Update narrative text for the Latest release section to use the
latest version.
.. 3. Add new 'upcoming' release.
If the new upcoming release docs arent ready, remove toctree from Upcoming
section and just leave narrative text. Update text for the upcoming release
version. Once the new upcoming docs are ready, add them in the toctree here.
.. Adding new release docs
.. 1. Make sure the most recent release versioned docs are complete for that
release.
.. 2. Make a copy of the most recent release folder e.g. 'r2_release.' Rename the
folder for the new release e.g. 'r3_release'.
.. 3. Search and replace all references to previous release number with the new
release number. For example replace all 'R2.0' with 'R3.0.' Also search and
replease any links that may have a specific release in the path.
.. 4. Link new version on this page (the index page).