From 1a677583719776a2744d8223e456aead3e82f680 Mon Sep 17 00:00:00 2001
From: Anton Steketee <79179784+anton-seaice@users.noreply.github.com>
Date: Tue, 7 Nov 2023 16:50:29 +1100
Subject: [PATCH] Update release.rst for #137

---
 docs/management/release.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/management/release.rst b/docs/management/release.rst
index e6300c5..74424e5 100644
--- a/docs/management/release.rst
+++ b/docs/management/release.rst
@@ -15,6 +15,13 @@ not include an update to the catalog on Gadi, skip the first two steps below:
       $ export RELEASE=vX.X.X
       $ cd bin
       $ qsub -v version=${RELEASE} build_all.sh
+
+   #. If the `schema <https://github.com/ACCESS-NRI/schema>`_ has changed, or you have not used the intake catalog recently, this step may fail with a *Network is unreachable* error trying to download the schema json files. To workaround::
+      
+      $ module use /g/data/hh5/public/modules/; module load conda/analysis3
+      $ python3 -c "from access_nri_intake import source, catalog"
+
+      This will cache a copy of the schema in your home directory. Then re-run ``$ qsub -v version=${RELEASE} build_all.sh``
     
 #. [IF UPDATING THE CATALOG] Upon successful completion of the previous step, the :code:`access_nri_intake` data package module 
    will be updated to point at the new version just created. Commit this update::
@@ -37,4 +44,4 @@ Alternatively (though discouraged), one can trigger the new release from the com
     $ git fetch --all --tags
     $ git commit --allow-empty -m "Release $RELEASE"
     $ git tag -a $RELEASE -m "Version $RELEASE"
-    $ git push --tags
\ No newline at end of file
+    $ git push --tags