Add benchmark documentation

docs.json

@@ -40,6 +40,12 @@
           "getting-started/user-management"
         ]
       },
+      {
+        "group": "FinOps Benchmark",
+        "pages": [
+          "finops-benchmark/overview"
+        ]
+      },
       {
         "group": "Workflow Management",
         "pages": [

finops-benchmark/overview.mdx

@@ -0,0 +1,50 @@
+---
+title: 'Benchmark'
+description: 'Automated cloud assessment that computes a cost efficiency score and a breakdown of savings opportunities.'
+icon: 'chart-column'
+---
+
+import JoinCommunity from '/snippets/join-community.mdx'
+
+**Benchmark** helps you run an **automated cloud assessment** across the provider you use with OpenOps. You choose your connection, scope, and which cost and efficiency checks to include. OpenOps automatically creates the workflows, runs them, and collects findings so you can prioritize savings and cleanup in one place.
+
+
+## What you get
+
+* A **library of checks** tuned to your selected provider - for example utilization and waste, rightsizing, and savings across compute, storage, databases, and related services.
+* A **benchmark report** in [Analytics](/reporting-analytics/analytics) so you can review KPIs and trends.
+
+## Running a benchmark
+
+1. Click **Run a Benchmark** on the OpenOps home page to start.
+2. Select your **cloud provider**. If you have no connection yet, create one when prompted.
+![Benchmark wizard — select cloud provider](/images/benchmark-wizard-provider.png)
+
+3. Choose the **connection** the benchmark should use.
+![Benchmark wizard — choose connection](/images/benchmark-wizard-connection.png)
+<Note>
+For **AWS**, OpenOps must be able to assume a role that includes the **read-only permissions** defined in the Benchmark CloudFormation stack. Use the link beside this step in the wizard to open the stack details. If that role is missing or incomplete, benchmark workflows can fail. For installation steps and templates, see [AWS CloudFormation role stacks](/cloud-access/aws-cf-role-stack).
+</Note>
+
+4. Select **accounts or subscriptions** and **regions** to include.
+![Benchmark wizard — accounts and regions](/images/benchmark-wizard-regions.png)
+
+5. Choose the **benchmark workflows** that correspond to the cost and efficiency checks you want this run to perform.
+![Benchmark wizard — select workflows](/images/benchmark-wizard-workflows.png)
+
+6. Click **Run** to execute the benchmark.
+7. When the run completes, open the benchmark report from the link in the wizard.
+
+
+## Benchmark report
+
+After a successful run, the **benchmark report** is built from benchmark opportunities and cost data from your chosen cloud provider. You will see:
+
+* **Summary metrics**: For example estimated monthly savings from open opportunities, total opportunity count, a **unified cost efficiency** metric (savings versus monthly cost context), and **monthly amortized cost over time**.
+* **Top opportunities to address**: A ranked view you can use to focus on the largest items first.
+* **Breakdown of savings**: Charts such as savings **by service**, **by region**, and **by account** so you can see where optimization potential clusters.
+
+Charts are **cross-linked**: Choose a service, region, or account in one chart to filter the rest of the dashboard. A short note on the dashboard reminds you that you can filter using those dimensions.
+
+
+<JoinCommunity />

introduction/features-and-benefits.mdx

@@ -25,4 +25,5 @@ Here's a rundown of the major features and benefits that OpenOps provides:
 * [Human-in-the-Loop](/workflow-management/human-in-the-loop) mechanisms to enforce control over critical optimizations. Before running deletions or scale-downs, you can make sure to get oversight and approval from stakeholders using notifications with quick action buttons.
 * [Tables](/reporting-analytics) to log opportunities and anomalies in a central location, with options to approve, dismiss, mark as false positive, or snooze. You can also use tables to process billing data, map resources to owners, or generate spend reports.
 * [Analytics](/reporting-analytics/data-visualization) to build charts and dashboards based on data in OpenOps tables or your existing data sources, such as CSV files, Google Sheets, Postgres databases, and more.
+* [FinOps Benchmark](/finops-benchmark/overview) to run automated cloud assessment that computes a cost efficiency score and a breakdown of savings opportunities.