Sync docs from Discourse (#609)

Co-authored-by: GitHub Actions <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

docs/explanation.md

@@ -0,0 +1,37 @@
+# Explanation
+
+Additional context about key concepts behind the MySQL K8s charm.
+
+## Core concepts and design
+* [Architecture]
+* [Interfaces and endpoints]
+* [Juju]
+* [Legacy charm]
+
+## Operational concepts
+* [Users]
+* [Logs]
+  * [Audit logs]
+
+## Security and hardening
+* [Security hardening guide][Security]
+  * [Cryptography]
+
+## Development
+* [Charm event flowcharts][Flowcharts]
+
+<!-- Links -->
+
+[Architecture]: /t/11757
+[Interfaces and endpoints]: /t/10249
+[Juju]: /t/11984
+[Legacy charm]: /t/11236
+
+[Users]: /t/10791
+[Logs]: /t/12080
+[Audit logs]: /t/15423
+
+[Security]: /t/16782
+[Cryptography]: /t/16783
+
+[Flowcharts]: /t/10031

docs/how-to.md

@@ -0,0 +1,98 @@
+# How-to guides
+
+Key processes and common tasks for managing and using Charmed MySQL on Kubernetes.
+
+## Deployment and setup
+
+Guidance for different cloud services:
+* [Canonical K8s]
+* [MicroK8s]
+* [GKE]
+* [EKS]
+* [AKS]
+* [Multi-AZ]
+
+Specific deployment scenarios and architectures:
+* [Terraform]
+* [Air-gapped]
+
+## Usage and maintenance
+* [Integrate with another application]
+* [External network access]
+* [Scale replicas]
+* [Enable TLS]
+
+## Back up and restore
+* [Configure S3 AWS]
+* [Configure S3 RadosGW]
+* [Create a backup]
+* [Restore a backup]
+* [Migrate a cluster]
+
+## Monitoring (COS)
+* [Enable monitoring]
+* [Enable alert rules]
+* [Enable tracing]
+
+## Upgrades
+See the [Upgrades landing page] for more details.
+* [Upgrade Juju]
+* [Perform a minor upgrade]
+* [Perform a minor rollback]
+
+## Cross-regional (cluster-cluster) async replication
+* [Deploy]
+* [Clients]
+* [Switchover / Failover]
+* [Recovery] 
+* [Removal]
+
+## Development
+* [Integrate with your charm]
+* [Migrate data via mysqldump]
+* [Migrate data via mydumper]
+* [Migrate data via backup/restore]
+* [Troubleshooting]
+
+<!--Links-->
+
+[Canonical K8s]: /t/15939
+[MicroK8s]: /t/11869
+[GKE]: /t/10875
+[EKS]: /t/12105
+[AKS]: /t/14306
+[Multi-AZ]: /t/15727
+[Terraform]: /t/14926
+[Air-gapped]: /t/15729
+
+[Integrate with another application]: /t/9657
+[External network access]: /t/15728
+[Scale replicas]: /t/9659
+[Enable TLS]: /t/9655
+
+[Configure S3 AWS]: /t/9651
+[Configure S3 RadosGW]: /t/10319
+[Create a backup]: /t/9653
+[Restore a backup]: /t/9663
+[Migrate a cluster]: /t/9661
+
+[Enable monitoring]: /t/9981
+[Enable alert rules]: /t/15488
+[Enable tracing]: /t/14448
+
+[Upgrades landing page]: /t/11754
+[Upgrade Juju]: /t/14333
+[Perform a minor upgrade]: /t/11752
+[Perform a minor rollback]: /t/11753
+
+[Deploy]: /t/13458
+[Clients]: /t/13459
+[Switchover / Failover]: /t/13460
+[Recovery]: /t/13467
+[Removal]: /t/13468
+
+[Integrate with your charm]: /t/11885
+[Migrate data via mysqldump]: /t/11992
+[Migrate data via mydumper]: /t/12006
+[Migrate data via backup/restore]: /t/12007
+[Troubleshooting]: /t/11886

docs/how-to/h-deploy-airgapped.md

@@ -26,7 +26,7 @@ Canonical does not prescribe how you should set up your specific air-gapped envi
 ## Air-gapped day-to-day example
 
 **1.** Exporting K8s Charms and OCI Resources are currently independent processes.
-> Sseveral improvements are planned:  [#1](https://warthogs.atlassian.net/browse/PF-5369), [#2](https://warthogs.atlassian.net/browse/PF-5185)
+> Several improvements are planned:  [#1](https://warthogs.atlassian.net/browse/PF-5369), [#2](https://warthogs.atlassian.net/browse/PF-5185)
 
 **1.1.** Charm. The necessary charm(s) can be exported as bundle OR independently (charm-by-charm). The special store-admin tool is designed to simplify the process. At the moment exporting of Charms and OCI resources are separated, but in the future the `store-admin export` [could](https://documentation.ubuntu.com/snap-store-proxy/en/airgap-charmhub/#export-charms) export all necessary OCI resource(s)) from official CharmHub.
 

docs/overview.md

@@ -32,16 +32,15 @@ Charmed MySQL K8s is an official distribution of MySQL. It’s an open-source pr
 
 | Level | Path | Navlink |
 |---------|---------|-------------|
-| 1 | tutorial | [Tutorial]() |
-| 2 | t-overview | [Overview](/t/9677) |
+| 1 | tutorial | [Tutorial](/t/9677) |
 | 2 | t-set-up | [1. Set up the environment](/t/9679) |
 | 2 | t-deploy | [2. Deploy MySQL](/t/9667) |
 | 2 | t-scale | [3. Scale replicas](/t/9675) |
 | 2 | t-manage-passwords | [4. Manage passwords](/t/9673) |
 | 2 | t-integrate | [5. Integrate applications](/t/9671)  |
 | 2 | t-enable-tls | [6. Enable TLS encryption](/t/9669) |
 | 2 | t-clean-up | [7. Clean up the environment](/t/9665) |
-| 1 | how-to | [How To]() |
+| 1 | how-to | [How-to guides](/t/17234) |
 | 2 | h-setup | [Deploy]() |
 | 3 | h-deploy-canonical-k8s | [Canonical K8s](/t/15939) |
 | 3 | h-deploy-microk8s | [MicroK8s](/t/11869) |
@@ -52,7 +51,7 @@ Charmed MySQL K8s is an official distribution of MySQL. It’s an open-source pr
 | 3 | h-deploy-terraform | [Terraform](/t/14926) |
 | 3 | h-deploy-airgapped | [Air-gapped](/t/15729) |
 | 2 | h-integrate| [Integrate with another application](/t/9657) |
-| 2 | h-external-access | [External access](/t/15728) |
+| 2 | h-external-access | [External network access](/t/15728) |
 | 2 | h-scale | [Scale replicas](/t/9659) |
 | 2 | h-enable-tls | [Enable TLS](/t/9655) |
 | 2 | h-backups | [Back up and restore]() |
@@ -69,39 +68,39 @@ Charmed MySQL K8s is an official distribution of MySQL. It’s an open-source pr
 | 3 | h-upgrade-juju | [Upgrade Juju](/t/14333) |
 | 3 | h-upgrade-minor | [Perform a minor upgrade](/t/11752) |
 | 3 | h-rollback-minor | [Perform a minor rollback](/t/11753) |
-| 2 | h-development| [Development]() |
-| 3 | h-development-integrate | [Integrate with your charm](/t/11885) |
-| 3 | h-migrate-mysqldump | [Migrate data via mysqldump](/t/11992) |
-| 3 | h-migrate-mydumper | [Migrate data via mydumper](/t/12006) |
-| 3 | h-migrate-backup-restore | [Migrate data via backup/restore](/t/12007) |
-| 3 | h-troubleshooting | [Troubleshooting](/t/11886) |
 | 2 | h-async | [Cross-regional async replication]() |
 | 3 | h-async-deployment | [Deploy](/t/13458) |
 | 3 | h-async-clients | [Clients](/t/13459) |
 | 3 | h-async-failover | [Switchover / Failover](/t/13460) |
 | 3 | h-async-recovery | [Recovery](/t/13467) |
 | 3 | h-async-removal | [Removal](/t/13468) |
+| 2 | h-development| [Development]() |
+| 3 | h-development-integrate | [Integrate with your charm](/t/11885) |
+| 3 | h-migrate-mysqldump | [Migrate data via mysqldump](/t/11992) |
+| 3 | h-migrate-mydumper | [Migrate data via mydumper](/t/12006) |
+| 3 | h-migrate-backup-restore | [Migrate data via backup/restore](/t/12007) |
+| 3 | h-troubleshooting | [Troubleshooting](/t/11886) |
 | 2 | h-contribute | [Contribute](/t/14655) |
-| 1 | reference | [Reference]() |
+| 1 | reference | [Reference](/t/17236) |
 | 2 | r-releases | [Releases](/t/11878) |
 | 2 | r-system-requirements | [System requirements](/t/11421) |
-| 2 | r-testing | [Testing](/t/11772) |
+| 2 | r-testing | [Software testing](/t/11772) |
 | 2 | r-profiles | [Profiles](/t/11892) |
 | 2 | r-plugins-extensions | [Plugins/extensions](/t/15482) |
 | 2 | r-alert-rules | [Alert rules](/t/15838) |
-| 2 | r-statuses | [Statuses](/t/11866) |
+| 2 | r-statuses | [Charm statuses](/t/11866) |
 | 2 | r-contacts | [Contacts](/t/11868) |
-| 1 | explanation | [Explanation]() |
+| 1 | explanation | [Explanation](/t/17238) |
 | 2 | e-architecture | [Architecture](/t/11757) |
 | 2 | e-interfaces-endpoints | [Interfaces/endpoints](/t/10249) |
+| 2 | e-juju | [Juju](/t/11984) |
+| 2 | e-legacy-charm | [Legacy charm](/t/11236) |
 | 2 | e-users | [Users](/t/10791) |
-| 2 | e-security | [Security](/t/16782) |
-| 2 | e-cryptography | [Cryptography](/t/16783) |
 | 2 | e-logs | [Logs](/t/12080) |
 | 3 | e-audit-logs | [Audit Logs](/t/15423) |
-| 2 | e-juju | [Juju](/t/11984) |
+| 2 | e-security | [Security](/t/16782) |
+| 2 | e-cryptography | [Cryptography](/t/16783) |
 | 2 | e-flowcharts | [Flowcharts](/t/10031) |
-| 2 | e-legacy-charm | [Legacy charm](/t/11236) |
 | 1 | search | [Search](https://canonical.com/data/docs/mysql/k8s) |
 
 [/details]

docs/reference.md

@@ -0,0 +1,23 @@
+# Reference
+
+Technical specifications, APIs, release notes, and other reference material for fast lookup.
+
+| Page                      | Description                                       |
+|-------------------------|-------------------------------------------------|
+| [Releases](/t/11878) | Overview of all Charmed MySQL K8s releases |
+| [System requirements](/t/11421) | Software and hardware requirements  |
+| [Software testing](/t/11772) | Software tests performed on this charm |
+| [Profiles](/t/11892) | Configurations related to performance |
+| [Plugins/extensions](/t/15482) |  Supported plugins/extensions |
+| [Alert rules](/t/15838) | Pre-configured Prometheus alert rules |
+| [Charm statuses](/t/11866) | Juju application statuses |
+| [Contacts](/t/11868) | Contact information |
+
+
+In the tabs at the top of this charm's [CharmHub page](https://charmhub.io/mysql-k8s/), you will find the following automatically generated references:
+
+| Page  | Description |
+|----------|-------------------|
+| [Integrations](https://charmhub.io/mysql-k8s/integrations) | Integration/relation interfaces supported by this charm |
+| [Configuration](https://charmhub.io/mysql-k8s/configuration) | Configuration parameters specific to this charm |
+| [Actions](https://charmhub.io/mysql-k8s/actions) | Juju actions supported by this charm |