diff --git a/doc/source/deploy_install_guides/index.rst b/doc/source/deploy_install_guides/index.rst index 4f5c2ac39..c81294dfa 100755 --- a/doc/source/deploy_install_guides/index.rst +++ b/doc/source/deploy_install_guides/index.rst @@ -1,23 +1,70 @@ ================================== -Deployment and installation guides +Installation and Deployment Guides ================================== -Deployment and installation guides for StarlingX are release-specific. -Each guide provides instruction on a specific StarlingX configuration -(e.g. All-in-one Simplex). - -The following list provides help on choosing the correct deployment guide: - .. toctree:: - :maxdepth: 1 + :hidden: latest/aio_simplex/index latest/aio_duplex/index -- Following are deployment and installation guides for past StarlingX - releases that have been archived: - * Currently, no archived deployment guides exist. +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 official release +*********************** + +The latest official release is the most recent officially +released version of StarlingX. + +^^^^^^^^^^^^^^^^^^ +Installation guide +^^^^^^^^^^^^^^^^^^ + +- `Installation stx.2018.10 <../../html/installation_guide/current/index.html>`__ + +^^^^^^^^^^^^^^^^^ +Deployment guides +^^^^^^^^^^^^^^^^^ + +- `All-in-one simplex stx.2018.10 <../../html/deployment_guides/current/simplex.html>`__ +- `All-in-one duplex stx.2018.10 <../../html/deployment_guides/current/duplex.html>`__ +- `Controller storage stx.2018.10 <../../html/deployment_guides/current/controller_storage.html>`__ +- `Dedicated storage stx.2018.10 <../../html/deployment_guides/current/dedicated_storage.html>`__ + +**************** +Upcoming release +**************** + +The upcoming release is the forthcoming version under development. + +^^^^^^^^^^^^^^^^^^^ +Deployment planning +^^^^^^^^^^^^^^^^^^^ + +- `Deployment planning <../../html/deployment_guides/latest/planning/index.html>`__ +- `Deployment options <../../html/deployment_guides/latest/options/index.html>`__ + +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Installation and deployment guides +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +- `All-in-one simplex R2.0 <../../html/deploy_install_guides/latest/aio_simplex/index.html>`__ +- `All-in-one duplex R2.0 <../../html/deploy_install_guides/latest/aio_duplex/index.html>`__ +- `Standard controller storage R2.0 <../../html/deploy_install_guides/latest/controller_storage/index.html>`__ +- `Standard dedicated storage R2.0 <../../html/deploy_install_guides/latest/dedicated_storage/index.html>`__ +- `Standard with Ironic <../../html/deployment_guides/latest/ironic/index.html>`__ +- `Multi-region <../../html/deployment_guides/latest/multi_region/index.html>`__ +- `Distributed cloud <../../html/deployment_guides/latest/dist_cloud/index.html>`__ + +***************** +Archived releases +***************** + +Currently, there are no archived guides. .. Steps you must take when a new release of the deployment and installation @@ -77,3 +124,4 @@ The following list provides help on choosing the correct deployment guide: + diff --git a/doc/source/index.rst b/doc/source/index.rst index 6011cce72..31c95ad15 100755 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -17,13 +17,18 @@ Sections :maxdepth: 1 introduction/index - deployment_guides/index - installation_guide/index + deploy_install_guides/index operation_guides/index contributor/index releasenotes/index developer_resources/index - deploy_install_guides/index + +.. toctree:: + :hidden: + + deployment_guides/index + installation_guide/index + -------- Projects diff --git a/doc/source/operation_guides/index.rst b/doc/source/operation_guides/index.rst index 9903fba5c..632cda8eb 100644 --- a/doc/source/operation_guides/index.rst +++ b/doc/source/operation_guides/index.rst @@ -3,37 +3,47 @@ Operation Guides ================ Operation guides for StarlingX are release-specific. -The following list provides help on choosing the correct operations guide: +Each guide provides instruction on a specific StarlingX +configuration (e.g. All-in-one Simplex). -- The "current" release is the most recent officially released version of StarlingX. - Following are the current operation guides: +*********************** +Latest official release +*********************** - .. toctree:: - :maxdepth: 1 +The latest official release is the most recent officially +released version of StarlingX. - ../api-ref/index +.. toctree:: + :maxdepth: 1 -- The "latest" release is the forthcoming version under development. - Following are the latest operation guides: + ../api-ref/index - .. toctree:: - :maxdepth: 1 +**************** +Upcoming release +**************** - ../api-ref/index - latest/cli_reference/index - latest/data_network_config/index - latest/ceph_storage_config/index - latest/sdn_networking/index - latest/kubernetes_cluster_guide/index - latest/swift_config_management/index - latest/fault_management/index - latest/patching_guide/index - latest/upgrade_guide/index +The upcoming release is the forthcoming version under development. -- Following are operation guides for past StartlingX releases that have - been archived: +.. toctree:: + :maxdepth: 1 - * Currently, no archived operation guides exist. + ../api-ref/index + latest/cli_reference/index + latest/data_network_config/index + latest/ceph_storage_config/index + latest/sdn_networking/index + latest/kubernetes_cluster_guide/index + latest/swift_config_management/index + latest/fault_management/index + latest/patching_guide/index + latest/upgrade_guide/index + + +***************** +Archived releases +***************** + +Currently, no archived guides exist. .. Steps you must take when a new release of the installer and developer guides occurs: @@ -45,7 +55,7 @@ The following list provides help on choosing the correct operations guide: becomes :doc:`Libvirt/QEMU /installation_libvirt_qemu>` 3. You might want to change your working directory to / and use Git to grep for - the "current" string (i.e. 'git grep "current" *'). For each applicable occurence, make + the "current" string (i.e. 'git grep "current" *'). For each applicable occurrence, make the call whether or not to convert the string to the actual archived string "". Be sure to scrub all files for the "current" string in both the "installation_guide" and "developer_guide" folders downward. @@ -57,7 +67,7 @@ The following list provides help on choosing the correct operations guide: becomes :doc:`Libvirt/QEMU ` 3. You might want to change your working directory to the "current" directory and use Git to grep for - the "latest" string (i.e. 'git grep "latest" *'). For each applicable occurence, make + the "latest" string (i.e. 'git grep "latest" *'). For each applicable occurrence, make the call whether or not to convert the string to "current". Be sure to scrub all files for the "latest" string in both the "installation_guide" and "developer_guide" folders downward. @@ -90,3 +100,4 @@ The following list provides help on choosing the correct operations guide: +