Add redeployment and external-access docs

.github/workflows/integration_test.yaml

@@ -7,7 +7,7 @@ on:
 jobs:
   integration-test:
     name: Integration Test
-    uses: canonical/operator-workflows/.github/workflows/integration_test.yaml@main
+    uses: canonical/operator-workflows/.github/workflows/integration_test.yaml@better-build
     secrets: inherit
     with:
       extra-arguments: >-

.github/workflows/integration_test_juju3.yaml

@@ -7,7 +7,7 @@ on:
 jobs:
   integration-test-juju3:
     name: Integration Test on Juju3
-    uses: canonical/operator-workflows/.github/workflows/integration_test.yaml@main
+    uses: canonical/operator-workflows/.github/workflows/integration_test.yaml@better-build
     secrets: inherit
     with:
       extra-arguments: >-

docs/how-to/redeployment.md

@@ -0,0 +1,37 @@
+# Redeployment Guide
+
+This guide provides the steps necessary for migrating an existing WordPress
+instance to a new charm instance.
+
+## Migrate Database
+
+Follow the instructions
+in [the mysql charm migration guide](https://charmhub.io/mysql/docs/h-migrate-cluster-via-restore)
+to migrate the content of the WordPress MySQL database.
+
+## Migrate Media Files
+
+### Media Files Stored in Kubernetes Storage
+
+If your media files are stored in Kubernetes
+storage (`wp_plugin_openstack-objectstorage_config` is not configured), use the
+following steps to migrate your files:
+
+1. Use the `kubectl cp` command to transfer files from
+   the `/var/www/html/wp-content/uploads` directory of the old `wordpress`
+   container to a local directory.
+2. Use the `kubectl cp` command again to copy these files from the local
+   directory to the `/var/www/html/wp-content/uploads` directory in the new
+   WordPress charm instance's `wordpress` container.
+
+### Media Files Stored in Object Storage
+
+If your media files are stored in object storage and
+the `wp_plugin_openstack-objectstorage_config` is not configured, you have two
+options:
+
+1. Provide the new WordPress charm instance with the same credentials and
+   connection information for the object storage. This allows the new instance
+   to automatically access the existing files.
+2. Use tools like [rclone](https://rclone.org) to copy files from the old
+   storage bucket to a new bucket for the new deployment.

docs/reference/external-access.md

@@ -0,0 +1,22 @@
+# External Access Requirements
+
+The WordPress charm may need to connect to external services and resources for
+certain functionalities.
+
+## OpenStack Object Storage
+
+When activated, the WordPress instance will need to connect to configured
+OpenStack object storage for uploading and retrieval of media and assets.
+
+## Akismet Spam Protection Plugin
+
+The Akismet spam protection plugin, when enabled via the `wp_plugin_akismet_key`
+configuration, requires internet access to connect with the Akismet API server.
+This connection is essential for verifying and managing spam content.
+
+## Installing Additional Plugins or Themes
+
+For the installation of additional plugins or themes, the WordPress instance
+must access the main WordPress site to download installation files. Some plugins
+or themes might also need internet access to operate correctly after they are
+installed.