Improve "how-to"s landing page (#31)

* Add Candid repo as link Signed-off-by: Babak K. Shandiz <[email protected]> * Organize how-to landing page Signed-off-by: Babak K. Shandiz <[email protected]> * Add link to Candid Signed-off-by: Babak K. Shandiz <[email protected]> --------- Signed-off-by: Babak K. Shandiz <[email protected]>
canonical · Apr 5, 2024 · b393eda · b393eda
1 parent e2e7ff2
commit b393eda
Show file tree

Hide file tree

Showing 3 changed files with 33 additions and 5 deletions.
diff --git a/explanation/index.rst b/explanation/index.rst
@@ -8,7 +8,7 @@ Explanation
    JAAS tags <jaas_tags>
    JAAS security <jaas_security_scope>
 
-- Candid - authentication server
+- `Candid`_ - authentication server
 
 - JIMM - Juju Intelligent Model Manager
 

diff --git a/how-to/index.rst b/how-to/index.rst
@@ -3,16 +3,43 @@ How-to guides
 
 These how-to guides cover key operations and processes in JAAS.
 
+Candid Deployment and Configuration
+-----------------------------------
+
+`Candid`_ serves as authentication service for JIMM. So you need a working Candid
+before deploying JIMM. Depending on the platform/requirements, some details of
+the Candid deployment could be different.
+
 .. toctree::
    :maxdepth: 1
 
-   Set up Route53 <route53>
-   Deploy JIMM <deploy_jimm>
-   Deploy JIMM on K8S <deploy_jimm_k8s>
-   Add controller <add_controller>
    Deploy Candid <deploy_candid>
    Deploy Candid on K8S <deploy_candid_k8s>
    Candid LDAP integration <candid_ldap_integration>
    Candid Azure integration <candid_azure_integration>
    Candid ADFS integration <candid_adfs_integration>
+
+
+JIMM Deployment
+---------------
+
+Here are instructions on how to deploy JIMM.
+
+.. toctree::
+   :maxdepth: 1
+
+   Deploy JIMM <deploy_jimm>
+   Deploy JIMM on K8S <deploy_jimm_k8s>
+
+
+JIMM Configuration
+------------------
+
+After JIMM has been deployed, you need to configure it with your Juju-operated cluster.
+
+.. toctree::
+   :maxdepth: 1
+
+   Add controller <add_controller>
    Cross-Model Queries <cross_model_queries>
+   Set up Route53 <route53>
diff --git a/reuse/links.txt b/reuse/links.txt
@@ -1 +1,2 @@
 .. _Canonical website: https://canonical.com/
+.. _Candid: https://github.com/canonical/candid
Original file line number	Diff line number	Diff line change
		@@ -1 +1,2 @@
		.. _Canonical website: https://canonical.com/
		.. _Candid: https://github.com/canonical/candid