Merge pull request #189461 from jonels-msft/hsc-toc-reorg

Reorganize Hyperscale table of contents

Author: tamarakhader

articles/azure-arc/data/concepts-distributed-postgres-hyperscale.md

@@ -47,7 +47,7 @@ The recommended distribution varies by the type of application and its query pat
 
 The first step in data modeling is to identify which of them more closely resembles your application.
 
-See details at [Determining application type](../../postgresql/hyperscale/concepts-app-type.md).
+See details at [Determining application type](../../postgresql/hyperscale/howto-app-type.md).
 
 
 ## Choose a distribution column
@@ -56,7 +56,7 @@ Why choose a distributed column?
 This is one of the most important modeling decisions you'll make. Azure Arc-enabled PostgreSQL Hyperscale stores rows in shards based on the value of the rows' distribution column. The correct choice groups related data together on the same physical nodes, which makes queries fast and adds support for all SQL features. 
 An incorrect choice makes the system run slowly and won't support all SQL features across nodes. This article gives distribution column tips for the two most common hyperscale scenarios.
 
-See details at [Choose distribution columns](../../postgresql/hyperscale/concepts-choose-distribution-column.md).
+See details at [Choose distribution columns](../../postgresql/hyperscale/howto-choose-distribution-column.md).
 
 
 ## Table colocation

articles/azure-arc/data/create-postgresql-hyperscale-server-group-azure-data-studio.md

@@ -82,8 +82,8 @@ While indicating 1 worker works, we do not recommend you use it. This deployment
 - [Monitor your server group](monitor-grafana-kibana.md)
 - Read the concepts and How-to guides of Azure Database for PostgreSQL Hyperscale to distribute your data across multiple PostgreSQL Hyperscale nodes and to benefit from all the power of Azure Database for Postgres Hyperscale. :
     * [Nodes and tables](../../postgresql/hyperscale/concepts-nodes.md)
-    * [Determine application type](../../postgresql/hyperscale/concepts-app-type.md)
-    * [Choose a distribution column](../../postgresql/hyperscale/concepts-choose-distribution-column.md)
+    * [Determine application type](../../postgresql/hyperscale/howto-app-type.md)
+    * [Choose a distribution column](../../postgresql/hyperscale/howto-choose-distribution-column.md)
     * [Table colocation](../../postgresql/hyperscale/concepts-colocation.md)
     * [Distribute and modify tables](../../postgresql/hyperscale/howto-modify-distributed-tables.md)
     * [Design a multi-tenant database](../../postgresql/hyperscale/tutorial-design-database-multi-tenant.md)*

articles/azure-arc/data/create-postgresql-hyperscale-server-group.md

@@ -200,8 +200,8 @@ psql postgresql://postgres:<EnterYourPassword>@10.0.0.4:30655
 - Connect to your Azure Arc-enabled PostgreSQL Hyperscale: read [Get Connection Endpoints And Connection Strings](get-connection-endpoints-and-connection-strings-postgres-hyperscale.md)
 - Read the concepts and How-to guides of Azure Database for PostgreSQL Hyperscale to distribute your data across multiple PostgreSQL Hyperscale nodes and to benefit from better performances potentially:
     * [Nodes and tables](../../postgresql/hyperscale/concepts-nodes.md)
-    * [Determine application type](../../postgresql/hyperscale/concepts-app-type.md)
-    * [Choose a distribution column](../../postgresql/hyperscale/concepts-choose-distribution-column.md)
+    * [Determine application type](../../postgresql/hyperscale/howto-app-type.md)
+    * [Choose a distribution column](../../postgresql/hyperscale/howto-choose-distribution-column.md)
     * [Table colocation](../../postgresql/hyperscale/concepts-colocation.md)
     * [Distribute and modify tables](../../postgresql/hyperscale/howto-modify-distributed-tables.md)
     * [Design a multi-tenant database](../../postgresql/hyperscale/tutorial-design-database-multi-tenant.md)*

articles/azure-arc/data/migrate-postgresql-data-into-postgresql-hyperscale-server-group.md

@@ -203,8 +203,8 @@ Within your Arc setup you can use `psql` to connect to your Postgres instance, s
 
 - Read the concepts and How-to guides of Azure Database for PostgreSQL Hyperscale to distribute your data across multiple PostgreSQL Hyperscale nodes and to benefit from all the power of Azure Database for PostgreSQL Hyperscale:
     * [Nodes and tables](../../postgresql/hyperscale/concepts-nodes.md)
-    * [Determine application type](../../postgresql/hyperscale/concepts-app-type.md)
-    * [Choose a distribution column](../../postgresql/hyperscale/concepts-choose-distribution-column.md)
+    * [Determine application type](../../postgresql/hyperscale/howto-app-type.md)
+    * [Choose a distribution column](../../postgresql/hyperscale/howto-choose-distribution-column.md)
     * [Table colocation](../../postgresql/hyperscale/concepts-colocation.md)
     * [Distribute and modify tables](../../postgresql/hyperscale/howto-modify-distributed-tables.md)
     * [Design a multi-tenant database](../../postgresql/hyperscale/tutorial-design-database-multi-tenant.md)*

articles/azure-arc/data/restore-adventureworks-sample-db-into-postgresql-hyperscale-server-group.md

@@ -69,8 +69,8 @@ kubectl exec <PostgreSQL pod name> -n <namespace name> -c postgres -- psql --use
 ## Suggested next steps
 - Read the concepts and How-to guides of Azure Database for PostgreSQL Hyperscale to distribute your data across multiple PostgreSQL Hyperscale nodes and to benefit from all the power of Azure Database for PostgreSQL Hyperscale. :
     * [Nodes and tables](../../postgresql/hyperscale/concepts-nodes.md)
-    * [Determine application type](../../postgresql/hyperscale/concepts-app-type.md)
-    * [Choose a distribution column](../../postgresql/hyperscale/concepts-choose-distribution-column.md)
+    * [Determine application type](../../postgresql/hyperscale/howto-app-type.md)
+    * [Choose a distribution column](../../postgresql/hyperscale/howto-choose-distribution-column.md)
     * [Table colocation](../../postgresql/hyperscale/concepts-colocation.md)
     * [Distribute and modify tables](../../postgresql/hyperscale/howto-modify-distributed-tables.md)
     * [Design a multi-tenant database](../../postgresql/hyperscale/tutorial-design-database-multi-tenant.md)*

articles/azure-arc/data/scale-out-in-postgresql-hyperscale-server-group.md

@@ -24,8 +24,8 @@ You scale in when you remove Postgres instances (Postgres Hyperscale worker node
 ## Get started
 If you are already familiar with the scaling model of Azure Arc-enabled PostgreSQL Hyperscale or Azure Database for PostgreSQL Hyperscale (Citus), you may skip this paragraph. If you are not, it is recommended you start by reading about this scaling model in the documentation page of Azure Database for PostgreSQL Hyperscale (Citus). Azure Database for PostgreSQL Hyperscale (Citus) is the same technology that is hosted as a service in Azure (Platform As A Service also known as PAAS) instead of being offered as part of Azure Arc-enabled Data Services:
 - [Nodes and tables](../../postgresql/hyperscale/concepts-nodes.md)
-- [Determine application type](../../postgresql/hyperscale/concepts-app-type.md)
-- [Choose a distribution column](../../postgresql/hyperscale/concepts-choose-distribution-column.md)
+- [Determine application type](../../postgresql/hyperscale/howto-app-type.md)
+- [Choose a distribution column](../../postgresql/hyperscale/howto-choose-distribution-column.md)
 - [Table colocation](../../postgresql/hyperscale/concepts-colocation.md)
 - [Distribute and modify tables](../../postgresql/hyperscale/howto-modify-distributed-tables.md)
 - [Design a multi-tenant database](../../postgresql/hyperscale/tutorial-design-database-multi-tenant.md)*
@@ -266,8 +266,8 @@ The scale-in operation is an online operation. Your applications continue to acc
 - Read about how to set server parameters in your Azure Arc-enabled PostgreSQL Hyperscale server group
 - Read the concepts and How-to guides of Azure Database for PostgreSQL Hyperscale to distribute your data across multiple PostgreSQL Hyperscale nodes and to benefit from all the power of Azure Database for Postgres Hyperscale. :
     * [Nodes and tables](../../postgresql/hyperscale/concepts-nodes.md)
-    * [Determine application type](../../postgresql/hyperscale/concepts-app-type.md)
-    * [Choose a distribution column](../../postgresql/hyperscale/concepts-choose-distribution-column.md)
+    * [Determine application type](../../postgresql/hyperscale/howto-app-type.md)
+    * [Choose a distribution column](../../postgresql/hyperscale/howto-choose-distribution-column.md)
     * [Table colocation](../../postgresql/hyperscale/concepts-colocation.md)
     * [Distribute and modify tables](../../postgresql/hyperscale/howto-modify-distributed-tables.md)
     * [Design a multi-tenant database](../../postgresql/hyperscale/tutorial-design-database-multi-tenant.md)*

articles/azure-arc/data/what-is-azure-arc-enabled-postgres-hyperscale.md

@@ -140,8 +140,8 @@ With the Direct connectivity mode offered by Azure Arc-enabled data services you
 
 - **Read the concepts and How-to guides of Azure Database for PostgreSQL Hyperscale to distribute your data across multiple PostgreSQL Hyperscale nodes and to potentially benefit from better performances**:
     * [Nodes and tables](../../postgresql/hyperscale/concepts-nodes.md)
-    * [Determine application type](../../postgresql/hyperscale/concepts-app-type.md)
-    * [Choose a distribution column](../../postgresql/hyperscale/concepts-choose-distribution-column.md)
+    * [Determine application type](../../postgresql/hyperscale/howto-app-type.md)
+    * [Choose a distribution column](../../postgresql/hyperscale/howto-choose-distribution-column.md)
     * [Table colocation](../../postgresql/hyperscale/concepts-colocation.md)
     * [Distribute and modify tables](../../postgresql/hyperscale/howto-modify-distributed-tables.md)
     * [Design a multi-tenant database](../../postgresql/hyperscale/tutorial-design-database-multi-tenant.md)*

articles/postgresql/.openpublishing.redirection.postgresql.json

@@ -320,6 +320,46 @@
         "redirect_url": "/azure/postgresql/hyperscale/quickstart-create-portal",
         "redirect_document_id": false
     },
+    {
+        "source_path_from_root": "/articles/postgresql/hyperscale/concepts-app-type.md",
+        "redirect_url": "/azure/postgresql/hyperscale/howto-app-type",
+        "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/hyperscale/concepts-choose-distribution-column.md",
+        "redirect_url": "/azure/postgresql/hyperscale/howto-choose-distribution-column",
+        "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/hyperscale/concepts-ssl-connection-security.md",
+        "redirect_url": "/azure/postgresql/hyperscale/howto-ssl-connection-security",
+        "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/hyperscale/concepts-limits.md",
+        "redirect_url": "/azure/postgresql/hyperscale/reference-limits",
+        "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/hyperscale/concepts-versions.md",
+        "redirect_url": "/azure/postgresql/hyperscale/reference-versions",
+        "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/hyperscale/concepts-extensions.md",
+        "redirect_url": "/azure/postgresql/hyperscale/reference-extensions",
+        "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/hyperscale/concepts-reserved-pricing.md",
+        "redirect_url": "/azure/postgresql/hyperscale/resources-pricing",
+        "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/hyperscale/concepts-configuration-options.md",
+        "redirect_url": "/azure/postgresql/hyperscale/resources-compute",
+        "redirect_document_id": false
+    },
     {
         "source_path_from_root": "/articles/postgresql/policy-samples.md",
         "redirect_url": "/azure/postgresql/policy-reference",

articles/postgresql/TOC.yml

@@ -632,7 +632,7 @@
           displayName: hyperscale, tutorial, real-time
       - name: Administer
         items:
-        - name: Private access
+        - name: Set up private access
           href: hyperscale/tutorial-private-access.md
           displayName: hyperscale, tutorial, private
   - name: Concepts
@@ -644,10 +644,6 @@
       - name: Nodes and tables
         href: hyperscale/concepts-nodes.md
         displayName: nodes, tables
-      - name: Determine application type
-        href: hyperscale/concepts-app-type.md
-      - name: Choose a distribution column
-        href: hyperscale/concepts-choose-distribution-column.md
       - name: Table colocation
         href: hyperscale/concepts-colocation.md
     - name: Security and data access
@@ -660,9 +656,6 @@
       - name: Private access
         href: hyperscale/concepts-private-access.md
         displayName: private, link, hyperscale
-      - name: Configure SSL
-        href: hyperscale/concepts-ssl-connection-security.md
-        displayName: hyperscale, ssl
       - name: Security baseline
         href: /security/benchmark/azure/baselines/postgresql-hyperscale-security-baseline?toc=/azure/postgresql/TOC.json?toc=/azure/postgresql/TOC.json
     - name: Scheduled maintenance
@@ -680,22 +673,12 @@
       href: hyperscale/concepts-connection-pool.md
     - name: Monitor and tune
       items:
-      - name: Monitor and tune
+      - name: Monitoring
         href: hyperscale/concepts-monitoring.md
       - name: Audit logs
         href: hyperscale/concepts-audit.md
     - name: Columnar storage
       href: hyperscale/concepts-columnar.md
-    - name: Configuration options
-      href: hyperscale/concepts-configuration-options.md
-    - name: Limits and limitations
-      href: hyperscale/concepts-limits.md
-    - name: Prepay for reserved capacity
-      href: hyperscale/concepts-reserved-pricing.md
-    - name: PostgreSQL versions
-      href: hyperscale/concepts-versions.md
-    - name: PostgreSQL extensions
-      href: hyperscale/concepts-extensions.md
   - name: How-to guides
     items:
     - name: Server group size
@@ -710,35 +693,34 @@
         href: hyperscale/howto-compute-quota.md
     - name: Security and data access
       items:
-      - name: Public access
-        items:
-        - name: Azure portal
-          href: hyperscale/howto-manage-firewall-using-portal.md
-          displayName: firewall rule, hyperscale
-      - name: Private access
-        items:
-        - name: Azure portal
-          href: hyperscale/howto-private-access.md
-          displayName: network, private link
+      - name: Manage public access
+        href: hyperscale/howto-manage-firewall-using-portal.md
+        displayName: firewall rule, hyperscale
+      - name: Manage private access
+        href: hyperscale/howto-private-access.md
+        displayName: network, private link
+      - name: Configure SSL
+        href: hyperscale/howto-ssl-connection-security.md
+        displayName: hyperscale, ssl
     - name: Create users
       href: hyperscale/howto-create-users.md
     - name: Distributed data
       items:
+      - name: Determine application type
+        href: hyperscale/howto-app-type.md
       - name: Determine table size
         href: hyperscale/howto-table-size.md
+      - name: Choose a distribution column
+        href: hyperscale/howto-choose-distribution-column.md
       - name: Distribute and modify tables
         href: hyperscale/howto-modify-distributed-tables.md
-    - name: High availability
+    - name: Configure high availability
       href: hyperscale/howto-high-availability.md
-    - name: Replication
-      items:
-      - name: Azure portal
-        href: hyperscale/howto-read-replicas-portal.md
-        displayName: replication, read replica
-    - name: Scheduled maintenance
-      items:
-      - name: Azure portal
-        href: hyperscale/howto-maintenance.md
+    - name: Manage read replicas
+      href: hyperscale/howto-read-replicas-portal.md
+      displayName: replication, read replica
+    - name: Schedule maintenance
+      href: hyperscale/howto-maintenance.md
     - name: Restart server group
       href: hyperscale/howto-restart.md
     - name: Monitor
@@ -752,10 +734,8 @@
         href: hyperscale/howto-logging.md
         displayName: log, hyperscale
     - name: Restore server group
-      items:
-      - name: Azure portal
-        href: hyperscale/howto-restore-portal.md
-    - name: Major version upgrades
+      href: hyperscale/howto-restore-portal.md
+    - name: Upgrade server group
       href: hyperscale/howto-upgrade.md
     - name: Troubleshoot
       items:
@@ -767,16 +747,32 @@
         displayName: read-only, hyperscale
       - name: Useful diagnostic queries
         href: hyperscale/howto-useful-diagnostic-queries.md
-  - name: API Reference
+  - name: Reference
     items:
-      - name: Overview
-        href: hyperscale/reference-overview.md
-      - name: SQL API functions
-        href: hyperscale/reference-functions.md
-      - name: Server parameters
-        href: hyperscale/reference-parameters.md
-      - name: System tables
-        href: hyperscale/reference-metadata.md
+      - name: PostgreSQL versions
+        href: hyperscale/reference-versions.md
+      - name: PostgreSQL extensions
+        href: hyperscale/reference-extensions.md
+      - name: Hyperscale (Citus) SQL API
+        items:
+        - name: Overview
+          href: hyperscale/reference-overview.md
+        - name: SQL functions
+          href: hyperscale/reference-functions.md
+        - name: Server parameters
+          href: hyperscale/reference-parameters.md
+        - name: System tables
+          href: hyperscale/reference-metadata.md
+      - name: Limits and limitations
+        href: hyperscale/reference-limits.md
+  - name: Resources
+    items:
+      - name: Pricing
+        href: hyperscale/resources-pricing.md
+      - name: Regional availability
+        href: hyperscale/resources-regions.md
+      - name: Compute and storage
+        href: hyperscale/resources-compute.md
 - name: Samples
   items:
   - name: Azure CLI samples

articles/postgresql/concepts-version-policy.md

@@ -65,4 +65,4 @@ Before PostgreSQL version 10, the [PostgreSQL versioning policy](https://www.pos
 ## Next steps
 - See Azure Database for PostgreSQL - Single Server [supported versions](./concepts-supported-versions.md)
 - See Azure Database for PostgreSQL - Flexible Server [supported versions](flexible-server/concepts-supported-versions.md)
-- See Azure Database for PostgreSQL - Hyperscale (Citus) [supported versions](hyperscale/concepts-versions.md)
+- See Azure Database for PostgreSQL - Hyperscale (Citus) [supported versions](hyperscale/reference-versions.md)