prioritize refresh terminology

Author: a-velasco

docs/how-to/index.md

@@ -43,8 +43,8 @@ Other deployment scenarios and configurations:
 * [Enable tracing] with Tempo
 * [Enable profiling] with Parca
 
-## Upgrades
-* [How to upgrade]
+## Refresh (upgrade)
+* [How to refresh]
     * [Perform a minor upgrade]
     * [Perform a minor rollback]
 
@@ -101,9 +101,9 @@ This section is for charm developers looking to support PostgreSQL integrations
 [Enable tracing]: /how-to/monitoring-cos/enable-tracing
 [Enable profiling]: /how-to/monitoring-cos/enable-profiling
 
-[How to upgrade]: /how-to/upgrade/index
-[Perform a minor upgrade]: /how-to/upgrade/minor-upgrade
-[Perform a minor rollback]: /how-to/upgrade/minor-rollback
+[How to upgrade]: /how-to/refresh/index
+[Perform a minor upgrade]: /how-to/refresh/minor-upgrade
+[Perform a minor rollback]: /how-to/refresh/minor-rollback
 
 [Cross-regional async replication]: /how-to/cross-regional-async-replication/index
 [Set up clusters]: /how-to/cross-regional-async-replication/set-up-clusters

docs/how-to/upgrade/index.md renamed to docs/how-to/refresh/index.md

@@ -1,4 +1,4 @@
-# Upgrade (refresh)
+# Refresh (upgrade)
 
 A charm **refresh** is any change to the version of a charm, and/or its {term}`workload`. 
 
@@ -11,8 +11,8 @@ This charm **can only be upgraded to a higher version**. It cannot be {term}`dow
 The charm version can only be lowered in the case of an ongoing refresh that needs to {term}`roll back <rollback>` to its {term}`original version` due to a failure.
 
 ```{seealso}
-* [How to perform a minor upgrade](/how-to/upgrade/minor-upgrade)
-* [How to perform a minor rollback](/how-to/upgrade/minor-rollback)
+* [How to perform a minor upgrade](/how-to/refresh/minor-upgrade)
+* [How to perform a minor rollback](/how-to/refresh/minor-rollback)
 ```
 
 ## Supported versions

docs/how-to/upgrade/minor-rollback.md renamed to docs/how-to/refresh/minor-rollback.md

@@ -10,7 +10,7 @@ The refresh process boils down to:
 Once in the refresh is in progress, the UI will clearly indicate what is happening to each unit, and what actions are required from the user to continue the process or roll back in case of a problem.
 
 ```{seealso}
-* [How to perform a minor rollback](/how-to/upgrade/minor-rollback)
+* [How to perform a minor rollback](/how-to/refresh/minor-rollback)
 * [All Charmed PostgreSQL minor versions](/reference/releases)
 * [](/how-to/back-up-and-restore/create-a-backup)
 * [Developer docs for charm-refresh](https://canonical-charm-refresh.readthedocs-hosted.com/latest/)