Docs: How-to landing and organization (#257)

* docs: add how-to landing page

* docs: basic landing page structure

* docs: initial sorting

* docs: add Discourse links

* docs: reorder basic operations

* docs: reorder TOC in overview

* fix: update links to Markdown files

* update index.md to remove nested reference

Author: erinecon

docs/how-to/index.md

@@ -0,0 +1,43 @@
+# How-to guides
+
+The following guides cover key processes and common tasks for managing
+and using the WordPress charm.
+
+## Initial setup
+* [Retrieve initial credentials]
+* [Configure initial settings]
+
+## Basic operations
+* [Configure hostname]
+* [Configure object storage]
+* [Install plugins]
+* [Install themes]
+* [Integrate with COS]
+
+## Security
+* [Enable antispam]
+* [Enable WAF]
+* [Rotate secrets]
+
+## Upgrade and redeployment 
+* [Upgrade WordPress charm]
+* [Redeploy]
+
+## Development
+* [Contribute]
+
+<!--Links-->
+
+[Retrieve initial credentials]: retrieve-initial-credentials.md
+[Configure initial settings]: configure-initial-settings.md
+[Integrate with COS]: integrate-with-cos.md
+[Configure hostname]: configure-hostname.md
+[Install plugins]: install-plugins.md
+[Install themes]: install-themes.md
+[Configure object storage]: configure-object-storage.md
+[Enable antispam]: enable-antispam.md
+[Enable WAF]: enable-waf.md
+[Rotate secrets]: rotate-secrets.md
+[Upgrade WordPress charm]: upgrade-wordpress-charm.md
+[Redeploy]: redeploy.md
+[Contribute]: contribute.md

docs/index.md

@@ -34,17 +34,19 @@ Thinking about using the WordPress Operator for your next project? [Get in touch
 
 1. [Tutorial](tutorial.md)
 1. [How-to](how-to)
-  1. [Contribute](how-to/contribute.md)
-  1. [Integrate with COS](how-to/integrate-with-cos.md)
-  1. [Enable antispam](how-to/enable-antispam.md)
-  1. [Enable WAF](how-to/enable-waf.md)
-  1. [Configure hostname](how-to/configure-hostname.md)
-  1. [Configure initial settings](how-to/configure-initial-settings.md)
   1. [Retrieve initial credentials](how-to/retrieve-initial-credentials.md)
+  1. [Configure initial settings](how-to/configure-initial-settings.md)
+  1. [Configure hostname](how-to/configure-hostname.md)
+  1. [Configure object storage](how-to/configure-object-storage.md)
   1. [Install plugins](how-to/install-plugins.md)
   1. [Install themes](how-to/install-themes.md)
-  1. [Configure object storage](how-to/configure-object-storage.md)
+  1. [Integrate with COS](how-to/integrate-with-cos.md) 
+  1. [Enable antispam](how-to/enable-antispam.md)
+  1. [Enable WAF](how-to/enable-waf.md)  
   1. [Rotate secrets](how-to/rotate-secrets.md)
+  1. [Upgrade WordPress charm](how-to/upgrade-wordpress-charm.md)
+  1. [Redeploy](how-to/redeploy.md)
+  1. [Contribute](how-to/contribute.md)
 1. [Reference](reference)
   1. [Actions](reference/actions.md)
   1. [Configurations](reference/configurations.md)