GOATS-1021: Update the user documentation to properly place the `Upda… (#507)

* GOATS-1021: Update the user documentation to properly place the `Updating` section

* Add towncrier entry.

Author: miguelgomezgomez

docs/changes/507.doc.rst

@@ -0,0 +1 @@
+Reorganized the user documentation to correctly place the “Updating” section.

docs/readthedocs/source/index.rst

@@ -48,7 +48,6 @@ GOATS relies on the following components -
    :caption: Table of Contents
 
    installation.rst
-   updating.rst
    overview.rst
    functionalities.rst
    acknowledgment.rst

docs/readthedocs/source/installation.rst

@@ -199,4 +199,8 @@ GOATS is actively developed and regularly updated. When a new version is availab
 See :ref:`updating` for full instructions on how to update GOATS safely and correctly.
 
 
+.. toctree::
+   :maxdepth: 1
+   :hidden:
 
+   updating.rst

docs/readthedocs/source/updating.rst

@@ -1,7 +1,7 @@
 .. _updating:
 
-Updating
-========
+Updating GOATS
+==============
 
 This guide explains how to update GOATS to the latest version.  
 The update process is simple and takes just a few minutes.
@@ -49,17 +49,22 @@ Automatic Version Check
 GOATS checks for newer versions every time you run ``goats run``. If your version is outdated, a warning like the following will appear:
 
 .. code-block:: text
+   
+    WARNING: A new version of GOATS is available: 25.11.3 (current: 25.11.0)
+    GOATS interacts with several external services (e.g., GPP, GOA, TNS)
+    which may evolve over time. Using an outdated version can result in
+    unexpected behavior or failed operations due to API changes or
+    incompatible features.
 
-   A new version of GOATS is available: 25.11.0 (current: 25.10.1)
+    Update steps:
+       • Stop GOATS
+       • Run: conda update goats
+       • Start GOATS again
 
-   GOATS interacts with several external services (e.g., GPP, GOA, TNS)
-       which may evolve over time. Using an outdated version can result in
-       unexpected behavior or failed operations due to API changes or
-       incompatible features.
+    ➤ For more details, visit https://goats.readthedocs.io/en/stable/updating.html
 
-   ➤ Visit https://goats.readthedocs.io/en/stable/updating.html for update instructions
+    Press Enter to continue at your own risk, or Ctrl+C to cancel...
 
-   Press Enter to continue at your own risk, or Ctrl+C to cancel...
 
 If your version is current, GOATS will confirm:
 
@@ -76,4 +81,4 @@ After restarting, verify the update with:
 
    goats --version
 
-You should see the updated version number displayed.
+You should see the updated version number displayed.