Replace labels with roles and add roles-labels extension (#848)

Co-authored-by: Fi Quick <[email protected]>

Author: recrwplay

modules/ROOT/pages/billing.adoc

@@ -1,10 +1,7 @@
 [[aura-Billing]]
 = Billing
 :description: Consumption reporting allows customers to monitor their billing and credit consumption.
-
-label:Aura-DB-Professional[]
-label:AuraDB-Business-Critical[]
-label:AuraDB-Virtual-Dedicated-Cloud[]
+:page-role: aura-db-professional aura-db-business-critical aura-db-dedicated
 
 Neo4j offers cloud services through two billing models. Prepaid consumption plans, where credits are deducted from the available balance each month. 
 Or pay-as-you-go, where usage is invoiced and charged on your credit card monthly in arrears.

modules/ROOT/pages/cloud-providers.adoc

@@ -2,10 +2,8 @@
 = Aura with cloud provider marketplaces
 :description: This page proved information about Neo4j Aura with cloud marketplaces.
 :page-aliases: platform/cloud-providers.adoc
+// :page-role: aura-db-dedicated aura-ds-enterprise aura-db-business-critical
 
-// label:AuraDB-Virtual-Dedicated-Cloud[]
-// label:AuraDS-Enterprise[]
-// label:AuraDB-Business-Critical[]
 
 You can subscribe to Neo4j Aura from cloud provider marketplaces.
 Your subscription gets billed together with other services that you're already using, and can contribute towards your spend commitment with cloud providers.
@@ -24,8 +22,7 @@ Credits from cloud marketplace providers cannot be used for payment towards Neo4
 ====
 
 
-label:AuraDB-Professional[]
-
+[role=label--aura-db-professional]
 == AWS Marketplace
 
 === Pay-as-you-go
@@ -60,8 +57,7 @@ You need to ensure that the marketplace organization is selected before you star
 mailto:[email protected][Contact us] to discuss private offers.
 
 
-label:AuraDB-Professional[]
-
+[role=label--aura-db-professional]
 == Azure Marketplace
 
 === Pay-as-you-go
@@ -93,9 +89,7 @@ You need to ensure that the marketplace organization is selected before you star
 
 mailto:[email protected][Contact us] to discuss private offers.
 
-label:AuraDB-Professional[]
-label:AuraDB-Business-Critical[]
-
+[role=label--aura-db-professional label--aura-db-business-critical]
 == Google Cloud Marketplace
 
 === Pay-as-you-go
@@ -121,8 +115,8 @@ After signing up to Neo4j Aura, two organizations are provisioned for you: a mar
 You need to ensure that the marketplace organization is selected before you start to deploy Neo4j.
 ====
 
-label:AuraDB-Professional[]
 [[legacy-subscription]]
+[role=label--aura-db-professional]
 === Legacy pay-as-you-go subscriptions
 
 If you subscribed to Neo4j Aura on the Google Cloud marketplace prior to September 19, 2025, you are running on a legacy marketplace subscription.
@@ -133,8 +127,8 @@ You can still log into the link:https://console.neo4j.io[Neo4j Aura console] dir
 Note that new users who need access to your existing Neo4j Aura GCP marketplace organization need to be added from the xref:user-management.adoc[User Management] settings within the Aura console.
 New users *cannot* be added directly via _Manage on provider_ from the Google Cloud console from the legacy GCP marketplace listing.
 
-label:AuraDB-Professional[]
 [[update-legacy]]
+[role=label--aura-db-professional]
 === Update your legacy subscriptions
 
 . Subscribe to the new link:https://console.cloud.google.com/marketplace/product/neo4j-mp-public/neo4j-aura[Neo4j Aura marketplace listing on Google Cloud]

modules/ROOT/pages/graph-analytics/index.adoc

@@ -12,11 +12,11 @@ If your data is in Aura or you plan to move it to Aura, you have several options
 
 If your data is in a self-managed Neo4j DBMS or a non-Neo4j data source, you can still use <<aura-gds-serverless, Aura Graph Analytics>>.
 
+
 [[aura-gds-plugin]]
+[role=label--aura-db-professional]
 == Graph Analytics plugin
 
-label:AuraDB-Professional[]
-
 The Graph Analytics plugin allows you to use the link:https://neo4j.com/docs/graph-data-science/current/introduction/[Graph Data Science library] in any AuraDB Professional instance with the following requirements:
 
 * Neo4j version 5 or later
@@ -28,6 +28,7 @@ It can also be changed with the link:https://neo4j.com/docs/aura/platform/api/sp
 
 The plugin shares compute and memory resources with the AuraDB server, so you do not incur any additional costs when you enable it.
 
+
 [[get-started-plugin]]
 === Getting started
 
@@ -36,6 +37,7 @@ With the Graph Analytics plugin enabled:
 * If you use the Neo4j Browser or run Cypher queries through a Neo4j driver, start with the link:{neo4j-docs-base-uri}/graph-data-science/current/getting-started/[Graph Data Science] tutorials.
 * If you use Python, start with the link:{neo4j-docs-base-uri}/graph-data-science-client/current/tutorials/tutorials/[Python client tutorials].
 
+
 [[aura-gds-serverless]]
 == Aura Graph Analytics
 
@@ -45,9 +47,9 @@ It runs in Aura as a link:{gds-sessions-page}[dedicated service] optimised for a
 You can enable, disable, and configure Aura Graph Analytics on the organization level in the xref:visual-tour/index.adoc#graph-analytics-org-settings[organization settings].
 The details on any running sessions are available in the xref:visual-tour/index.adoc#graph-analytics-page[Graph Analytics] page.
 
-=== From an AuraDB instance
 
-label:AuraDB-Professional[] label:AuraDB-Business-Critical[] label:AuraDB-Virtual-Dedicated-Cloud[]
+[role=label--aura-db-professional label--aura-db-business-critical label--aura-db-dedicated]
+=== From an AuraDB instance
 
 [IMPORTANT]
 ====
@@ -70,11 +72,11 @@ With the Aura API credentials available:
 * If you use Python, start with one of the Python client tutorials depending on whether your data is in
 link:{neo4j-docs-base-uri}/graph-data-science-client/current/tutorials/graph-analytics-serverless/[AuraDB], in a link:{neo4j-docs-base-uri}//graph-data-science-client/current/tutorials/graph-analytics-serverless-self-managed/[self-managed Neo4j database], or a link:{neo4j-docs-base-uri}//graph-data-science-client/current/tutorials/graph-analytics-serverless-standalone/[non-Neo4j data source].
 
+
 [[aura-ds]]
+[role=label--aura-ds-professional label--aura-ds-enterprise]
 == AuraDS
 
-label:AuraDS-Professional[] label:AuraDS-Enterprise[]
-
 AuraDS is the fully managed version of the Graph Data Science library where the <<aura-gds-plugin>> is deployed by default.
 
 In an AuraDS instance, Graph Analytics is always on.

modules/ROOT/pages/logging/download-logs.adoc

@@ -114,10 +114,9 @@ Downloaded query logs take the form of a zipped JSON file that, when extracted,
 
 |===
 
-== Security logs
 
-label:AuraDB-Enterprise[]
-label:AuraDS-Enterprise[]
+[role=label--AuraDB-Enterprise label--aura-ds-enterprise]
+== Security logs
 
 A security log provides a log of all the security events that have occurred on an instance within a specified time range.
 

modules/ROOT/pages/logging/log-downloads.adoc

@@ -7,9 +7,7 @@
 :max-request-hours: 24
 :role-project-admin: Project Admin
 :role-project-member: Project Member
-
-label:AuraDB-Professional[]
-label:AuraDB-Virtual-Dedicated-Cloud[]
+:page-role: aura-db-professional aura-db-dedicated
 
 Downloading logs requires a role of either _{role-project-admin}_ or _{role-project-member}_.
 

modules/ROOT/pages/logging/log-forwarding.adoc

@@ -1,10 +1,8 @@
 [[aura-query-logs]]
 = Log forwarding
 :page-aliases: platform/logging/log-forwarding.adoc
+:page-role: aura-db-business-critical aura-db-dedicated aura-ds-enterprise
 
-label:AuraDB-Business-Critical[]
-label:AuraDB-Virtual-Dedicated-Cloud[]
-label:AuraDS-Enterprise[]
 
 With log forwarding, you can stream logs directly to a cloud project owned by your organization, in real time. 
 The following types of logs are available:
@@ -48,9 +46,9 @@ Exhaustive instructions are provided in the wizard which appears by following th
 
 . Navigate to the *Log forwarding* page as described above.
 . Use *Configure log forwarding* and select the scope for log forwarding.
-* label:AuraDB-Business-Critical[] A specific instance will have its logs forwarded.
-* label:AuraDB-Virtual-Dedicated-Cloud[] All instances in the selected region will have their logs forwarded.
-* label:AuraDS-Enterprise[] All instances in the selected region will have their logs forwarded.
+* label:AuraDB-business-critical[] A specific instance will have its logs forwarded.
+* label:AuraDB-virtual-dedicated-cloud[] All instances in the selected region will have their logs forwarded.
+* label:AuraDS-enterprise[] All instances in the selected region will have their logs forwarded.
 . Select the type of logs to forward: *Security logs* or *Query logs*.
 * For query logs, it is possible to apply certain filters to decrease the volume of forwarded data.
 . Follow the instructions specific to your cloud provider.

modules/ROOT/pages/logging/query-log-analyzer.adoc

@@ -4,10 +4,7 @@
 :page-alisases: platform/logging/query-log-analyzer.adoc
 :log-retention-days: 30
 :max-request-hours: 24
-
-label:AuraDB-Professional[]
-label:AuraDB-Business-Critical[]
-label:AuraDB-Virtual-Dedicated-Cloud[]
+:page-role: aura-db-professional aura-db-business-critical aura-db-dedicated
 
 Query log analyzer is a feature that provides a UI to review the queries executed on an Aura instance.
 

modules/ROOT/pages/logging/security-log-analyzer.adoc

@@ -1,12 +1,9 @@
-:log-retention-days: 30
-:max-request-hours: 24
-
 [[aura-monitoring]]
 = Security log analyzer
+:log-retention-days: 30
+:max-request-hours: 24
+:page-role: aura-db-professional aura-db-business-critical aura-db-dedicated
 
-label:AuraDB-Professional[]
-label:AuraDB-Business-Critical[]
-label:AuraDB-Virtual-Dedicated-Cloud[]
 
 Security log analyzer is a feature that provides a UI to review the security events on an Aura instance.
 

modules/ROOT/pages/managing-instances/advanced-metrics.adoc

@@ -1,8 +1,7 @@
 [[aura-monitoring]]
 = Advanced metrics
+:page-role: AuraDB-Enterprise aura-db-professional
 
-label:AuraDB-Professional[]
-label:AuraDB-Enterprise[]
 
 Advanced metrics is a feature that enables access to a broad range of different instance and database metrics.
 
@@ -36,24 +35,27 @@ When viewing metrics, you can select from the following time intervals:
 Memory and storage charts can be toggled between absolute and relative values using the *%* toggle.
 ====
 
-=== Toggle data series
 
-label:AuraDB-Enterprise[]
+[role=label--AuraDB-Enterprise]
+=== Toggle data series
 
 To hide or show individual data series, select the corresponding data series in the legend below the chart.
 
+
 === Zoom
 
 To zoom in to a narrower time interval, select and drag inside any chart to select your desired time interval.
 The data will automatically update to match the increased resolution.
 
 To reset zoom, double-click anywhere inside the chart or use the option in the context menu.
 
+
 === Expand
 
 Any chart can be expanded to take up all the available screen estate by clicking the *expand* button (shown as two opposing arrows).
 To exit this mode, click the *x* button on the expanded view.
 
+
 === Context menu
 
 To access the chart context menu, select the *...* button on any chart.
@@ -63,9 +65,9 @@ For some metrics it also provides hints about possible actions to take if that m
 
 * *Reset zoom* - If the zoom level has been altered by selecting and dragging across a chart, *Reset zoom* resets the zoom back to the selected interval.
 
-== Aggregations
 
-label:AuraDB-Enterprise[]
+[role=label--AuraDB-Enterprise]
+== Aggregations
 
 Most metrics will have several values for a given timestamp because of the following reasons:
 
@@ -82,12 +84,15 @@ The possible aggregations are:
 * *Average* - The average value of the metric across all cluster members.
 * *Sum* - The sum of the metric across all cluster members.
 
+
 == Store size metrics
 
+
 === Resources tab
 
 The chart on the _Resources_ tab shows the allocated store size metric for the selected database either as a percentage of the available storage assigned for the database or as absolute values.
 
+
 === Database tab
 
 The _Database_ tab provides a chart that shows the store size and the portion of the allocated space that the database is actively utilizing.

modules/ROOT/pages/managing-instances/backup-restore-export.adoc

@@ -17,32 +17,31 @@ See <<snapshot-details>> for more information.
 Aura stores the data securely in encrypted cloud storage buckets.
 Backups are stored in the same Cloud Service Provider and region as the instance they are associated with.
 
+
 == Snapshot types
 
-=== Scheduled
 
-label:AuraDB-Professional[]
-label:AuraDB-Business-Critical[]
-label:AuraDB-Virtual-Dedicated-Cloud[]
-label:AuraDS-Professional[]
-label:AuraDS-Enterprise[]
+[role=label--aura-db-professional label--aura-db-business-critical label--aura-db-dedicated label--aura-ds-professional label--aura-ds-enterprise]
+=== Scheduled
 
 A *Scheduled* snapshot is a snapshot that is automatically triggered at a cadence depending on your tier.
 
 For Professional instances running the latest version, scheduled snapshots are run automatically once a day, same for both AuraDS Professional and for AuraDS Enterprise instances, For Business Critical and Virtual Dedicated Cloud instances, they run once an hour.
 See <<snapshot-details>> further on for information about frequency, restorability, and exportability of scheduled snapshots, as well snapshots on instances running version 4.x.
 
+
 === On Demand
 
 An *On Demand* snapshot is a snapshot that you manually trigger with the *Take snapshot* button.
 This type of snapshot is the only snapshot available for Free instances.
 
+
 == Snapshot actions
 
 image::snapshot-actions.png[width=400]
 
-[[export-create]]
 
+[[export-create]]
 === Export / Create
 
 From the more menu (...) next to an existing snapshot, you can: