Fix spelling, broken links, and navigation issues (#666)

* fix toctrees and landing pages

* fix spelling and link errors

* add doc ci workflow

* small fixes

* remove update script

* Add mysql.com domains to linkcheck ignore

* generalize azure portal url to ignore in linkcheck

* remove emojis and discourse underline notation

* update contacts page

* Update docs/how-to/development/migrate-data-via-backup-restore.md

Co-authored-by: Paulo Machado <[email protected]>

* update legacy charm warning

---------

Co-authored-by: Paulo Machado <[email protected]>

Author: a-velasco

.github/workflows/automatic-doc-checks.yml

@@ -0,0 +1,24 @@
+#
+name: Automatic doc checks
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    paths:
+      - 'docs/**'   # Only run on changes to the docs directory
+
+  workflow_dispatch:
+    # Manual trigger
+
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  documentation-checks:
+    uses: canonical/documentation-workflows/.github/workflows/documentation-checks.yaml@main
+    with:
+      working-directory: "docs"
+      fetch-depth: 0

docs/.custom_wordlist.txt

@@ -1,33 +1,60 @@
 # Leave a blank line at the end of this file to support concatenation
+airgap
+async
 backend
 backends
+backport
 Charmcraft
 cjk
 cryptographically
+databag
 dvipng
 fonts
 freefont
+Furo
 github
+GitHub
 GPG
 gyre
-https
 html
-io
+https
+InnoDB
 Intersphinx
+io
+ip
+Jira
+landscape
 lang
+lastmod
 LaTeX
 latexmk
+MinIO
 Multipass
+mydumper
+mysql
+MyST
+nameserver
+nameservers
+Open Graph
 otf
+PDF
+Percona
 plantuml
 PNG
+PR
 Pygments
 pymarkdown
 QEMU
-Rockcraft
+Read the Docs
 readthedocs
+reStructuredText
+Rockcraft
 rst
 sitemapindex
+snap_daemon
+Sphinx
+Spread
+spread_test_example
 subproject
 subprojects
 SVG
@@ -37,29 +64,17 @@ TOC
 toctree
 txt
 uncommenting
+URL
 utils
 VMs
 WCAG
 whitespace
 whitespaces
 wordlist
+xbstream
 xetex
 xindy
 xml
-ip
-spread_test_example
-Furo
-PDF
-Open Graph
-MyST
-YouTube
-reStructuredText
-GitHub
-Sphinx
-URL
-PR
-Read the Docs
-Spread
-landscape
-lastmod
+xtrabackup
 yaml
+YouTube