canonical-ubuntu-qa team mailing list archive

[Tim Andersson <mp+452666@xxxxxxxxxxxxxxxxxx>]

Tim Andersson has proposed merging ~andersson123/autopkgtest-cloud:doc_update into autopkgtest-cloud:master.

Requested reviews:
  Canonical's Ubuntu QA (canonical-ubuntu-qa)

For more details, see:
https://code.launchpad.net/~andersson123/autopkgtest-cloud/+git/autopkgtest-cloud/+merge/452666
-- 
Your team Canonical's Ubuntu QA is requested to review the proposed merge of ~andersson123/autopkgtest-cloud:doc_update into autopkgtest-cloud:master.

diff --git a/docs/deploying.rst b/docs/deploying.rst
index 29ed85d..630743c 100644
--- a/docs/deploying.rst
+++ b/docs/deploying.rst
@@ -128,6 +128,19 @@ Making configuration changes
 
 Edit the ``service-bundle`` file as above, and run ``mojo run`` again.
 
+autopkgtest-cloud Storage
+----------------------------
+
+There is a quota for storage in the ``autopkgtest-cloud`` environment.
+Sometimes when a unit is deleted, the storage for that unit can be
+left in a "detached" state, but still exist, taking up part of the
+quota. ``mojo run`` will usually throw an error in this state, and
+there will be an error message regarding the quota being exceeded.
+
+``juju storage`` will show all the current storage, and
+``juju remove-storage storage-name/99`` will remove the storage.
+
+
 Update the code
 ---------------
 
@@ -168,6 +181,11 @@ Where $charm is either equal to "web" or "cloud-worker".
 Then run ``mojo run`` on the system where you want to deploy the update - this
 will pull the updated charm from the charm store.
 
+Please note, if you have made changes to the charm that change the package dependencies,
+a mojo run will not update this on the relevant units. For this to take place, you must
+either ``remove-unit`` and ``add-unit`` the relevant unit, or install the new dependencies
+manually on the unit.
+
 Tagging the charm revisions
 ---------------
 
diff --git a/docs/docs.rst b/docs/docs.rst
index 8ab1ddd..c695366 100644
--- a/docs/docs.rst
+++ b/docs/docs.rst
@@ -1,8 +1,7 @@
 Updating this documentation
 ===========================
 
-Until `readthedocs.org supports Launchpad webhooks
-<https://github.com/readthedocs/readthedocs.org/issues/8137>`_ and they are
-updated automatically on push, you need to visit the readthedocs web
-interface and issue a manual build to have this documentation update. Contact
-an admin for this.
+To update this documentation, simply create an MP for ``autopkgtest-cloud`` - once the
+MP is merged, this documentation will get updated automatically. The repository is
+checked once a day for documentation changes, and if doc changes are found a build is
+triggered on readthedocs.