diff --git a/docs/index.rst b/docs/index.rst
index 2cd6bd3a..b6f80a13 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,4 +1,4 @@
-The esgcet package for ESGF Publication - Version 5.2.2
+The esgcet package for ESGF Publication - Version 5.2.3
 =======================================================
 
 Esgcet is a package of publisher commands for publishing to the `ESGF
@@ -13,7 +13,7 @@ If you have conda on a Linux system you can install the publisher wih the follow
      conda create -n esgf-pub -c conda-forge pip cmor  # most commun
      conda activate esgf-pub
      pip install esgcet  
-     esgpublish --version #  Ensure you have upgraded to v5.2.1
+     esgpublish --version #  Ensure you have upgraded to v5.2.3
      esgpublish # will print the usage information.
 
 
diff --git a/docs/install.rst b/docs/install.rst
index e29dc012..e667f104 100644
--- a/docs/install.rst
+++ b/docs/install.rst
@@ -23,7 +23,7 @@ Use the following command to install ``esgcet`` into a previously created conda
 
     conda activate esgf-pub
     pip install esgcet 
-    esgpublish --version #  Ensure you have upgraded to v5.2.1
+    esgpublish --version #  Ensure you have upgraded to v5.2.3
 
 
 Installing esgcet via git
@@ -34,10 +34,9 @@ To install esgcet by cloning our github repository (useful if you want to modiy
 
     git clone http://github.com/ESGF/esg-publisher.git 
     cd esg-publisher
-    git checkout refactor-esgf # NOTE this is a temporary fix prior to a merge into the master branch
     cd src/python
     pip install -e .  # You can modify the source in place
-    esgpublish --version  # Confirm that v5.2.1 has been installed
+    esgpublish --version  # Confirm that v5.2.3 has been installed
 
 Now you will be able to call all commands in this package from any directory.  
 
diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst
index 1e4110ee..a7ab6183 100644
--- a/docs/troubleshooting.rst
+++ b/docs/troubleshooting.rst
@@ -9,3 +9,8 @@ If you encounter issues running any of the esgcet commands, try looking for comm
    feel free to open a github issue and request that support for your project is added.
  - For example commands and test scripts, see our `test suite repository <https://github.com/lisi-w/test-suite/tree/main>`_.
  - For unexpected behavior, output, or errors, please open a `Github Issue <https://github.com/ESGF/esg-publisher/issues>`_.
+
+ Known issues
+ ------------
+
+ * There is a problem identified with esgunpublish and connecting to the PID server.  Please report if you need support and a team member will assist.
diff --git a/docs/whatsnew.rst b/docs/whatsnew.rst
index b09411fb..6d1d5837 100644
--- a/docs/whatsnew.rst
+++ b/docs/whatsnew.rst
@@ -1,6 +1,16 @@
 Release Notes
 =============
 
+v5.2.3
+------
+
+* Update argument processing to make ``--cert`` an optional argument to align with changes in ESGF architecture
+* Bugfixes to support optional citation and further info URLs
+* Support of customized ``https_url`` in the configuration for non- ``thredds/fileServer`` endpoints.
+* Introduction of ``globus_url`` inclusion for direct link to the Globus file manager.
+* **BUGFIX** for a default ``esg.yaml`` under the ``.esg`` hidden directory
+
+
 v5.2.2
 ------