docs: update how-to and reference landing pages

docs/how-to/index.rst

@@ -6,18 +6,17 @@
 How-to guides
 =============
 
-The following guides cover key processes and common tasks for managing and
-using the aproxy charm.
+Manage the aproxy charm through its full operations lifecycle.
 
 .. vale Canonical.013-Spell-out-numbers-below-10 = NO
 .. vale Canonical.500-Repeated-words = NO
 
 Basic operations
 ----------------
 
-Once you've finished setting up the charm, now you can perform a number
-of actions with your deployment. These guides provide instructions on
-basic operations you can complete with the charm.
+Day-to-day tasks such as configuring proxy settings and integrating with
+observability tools keep your aproxy deployment functioning correctly and
+connected to the rest of your infrastructure.
 
 .. toctree::
     :hidden:
@@ -26,26 +25,16 @@ basic operations you can complete with the charm.
     Configure <configure>
     Integrate with COS <integrate-with-cos>
 
-Update and refresh
-------------------
+Maintenance and development
+---------------------------
 
-The following guides provide instructions on upgrading your deployment,
-including backup and restore processes.
+Upgrades, back ups, and community contributions ensure the aproxy
+charm stays current, reliable, and benefits from ongoing improvements.
 
 .. toctree::
     :hidden:
     :maxdepth: 1
 
     Back up and restore <back-up-restore>
     Upgrade <upgrade>
-
-Development
------------
-
-These guides can help you with contributing to the project.
-
-.. toctree::
-    :hidden:
-    :maxdepth: 1
-
     Contribute <contribute>

docs/reference/index.rst

@@ -6,37 +6,40 @@
 Reference
 =========
 
-This section contains technical details and information about the aproxy charm.
-
-Charm usage
------------
-
-The following pages provide more information about the charm's features,
-including actions, configurations, and integrations.
+Technical specifications and architectural details for the aproxy charm serve
+as authoritative look-up material when configuring, integrating, or extending
+the charm.
 
 .. vale Canonical.013-Spell-out-numbers-below-10 = NO
 .. vale Canonical.500-Repeated-words = NO
 .. vale Canonical.004-Canonical-product-names = NO
 
+Configuration and operations
+----------------------------
+
+Operators control charm behaviour through configuration options and Juju
+actions. Understanding the charm architecture provides the structural context
+needed to see how those settings interact at runtime.
+
 .. toctree::
     :hidden:
     :maxdepth: 1
 
     Actions <actions>
     Configurations <configurations>
-    Integrations <integrations>
-    Metrics <metrics>
+    Charm architecture <charm-architecture>
 
 .. vale Canonical.004-Canonical-product-names = YES
 
-Architecture and deployments
-----------------------------
+Connectivity and monitoring
+---------------------------
 
-The following pages provide more details about the charm architecture and
-a high-level deployment with any required dependencies.
+The aproxy charm communicates with other applications through integrations and
+exposes operational metrics to support observability and alerting.
 
 .. toctree::
     :hidden:
     :maxdepth: 1
 
-    Charm architecture <charm-architecture>
+    Integrations <integrations>
+    Metrics <metrics>