From 6dc0e7726394b876a91bfa70c16cb390cd0d28ba Mon Sep 17 00:00:00 2001 From: Hasan Abo-Shally Date: Wed, 20 May 2026 18:23:37 +0300 Subject: [PATCH 1/4] docs: add disclaimer about preview APIs and items --- .changes/unreleased/docs-preview-disclaimer.yaml | 4 ++++ docs/index.md | 3 +++ 2 files changed, 7 insertions(+) create mode 100644 .changes/unreleased/docs-preview-disclaimer.yaml diff --git a/.changes/unreleased/docs-preview-disclaimer.yaml b/.changes/unreleased/docs-preview-disclaimer.yaml new file mode 100644 index 000000000..a60faa32f --- /dev/null +++ b/.changes/unreleased/docs-preview-disclaimer.yaml @@ -0,0 +1,4 @@ +kind: docs +body: Add a note to the docs landing page clarifying that the GA CLI may support preview items and rely on preview APIs that aren't covered by the standard Fabric SLA +custom: + Author: HasanAboShally diff --git a/docs/index.md b/docs/index.md index eae669116..30d9cbd25 100644 --- a/docs/index.md +++ b/docs/index.md @@ -7,6 +7,9 @@ hide: The Fabric CLI (`fab`) gives you command-line access to Microsoft Fabric. Manage workspaces, run pipelines, and automate data workflows - all from your terminal. +!!! note "Preview APIs and items" + The Fabric CLI is generally available (GA), but it may support Fabric items that are still in preview, and some commands may rely on Fabric public APIs that are still in [preview](https://learn.microsoft.com/rest/api/fabric/articles/api-structure#api-endpoints). Preview items and APIs aren't covered by the standard Fabric SLA. + --- ## Why use the CLI? From 872dd4dc477c34f1697f36f9ba3c89cec3b16315 Mon Sep 17 00:00:00 2001 From: Hasan Abo-Shally Date: Wed, 20 May 2026 18:28:47 +0300 Subject: [PATCH 2/4] docs: move preview caveat into a Release status section --- docs/index.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/index.md b/docs/index.md index 30d9cbd25..c56c10db2 100644 --- a/docs/index.md +++ b/docs/index.md @@ -7,9 +7,6 @@ hide: The Fabric CLI (`fab`) gives you command-line access to Microsoft Fabric. Manage workspaces, run pipelines, and automate data workflows - all from your terminal. -!!! note "Preview APIs and items" - The Fabric CLI is generally available (GA), but it may support Fabric items that are still in preview, and some commands may rely on Fabric public APIs that are still in [preview](https://learn.microsoft.com/rest/api/fabric/articles/api-structure#api-endpoints). Preview items and APIs aren't covered by the standard Fabric SLA. - --- ## Why use the CLI? @@ -30,6 +27,13 @@ Get powerful control over your Fabric resources: - **Built on public APIs** - Fabric REST, OneLake, and Microsoft.Fabric ARM endpoints. +## Release status + +The Fabric CLI is generally available (GA). For the current version and changelog, see the [release notes](./release-notes.md). Run `fab --version` to check your installed version. + +**Note:** The CLI may support Fabric items that are still in preview, and some commands may rely on Fabric public APIs that are still in [preview](https://learn.microsoft.com/rest/api/fabric/articles/api-structure#api-endpoints). Preview items and APIs aren't covered by the standard Fabric SLA. + + ## Get started ### What you need From 194d43ed115134f8ad1341f2c88e66fc7aa61d0d Mon Sep 17 00:00:00 2001 From: Hasan Abo-Shally Date: Wed, 20 May 2026 18:31:36 +0300 Subject: [PATCH 3/4] docs: update changie entry to match Release status framing --- .changes/unreleased/docs-preview-disclaimer.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.changes/unreleased/docs-preview-disclaimer.yaml b/.changes/unreleased/docs-preview-disclaimer.yaml index a60faa32f..96064ce52 100644 --- a/.changes/unreleased/docs-preview-disclaimer.yaml +++ b/.changes/unreleased/docs-preview-disclaimer.yaml @@ -1,4 +1,4 @@ kind: docs -body: Add a note to the docs landing page clarifying that the GA CLI may support preview items and rely on preview APIs that aren't covered by the standard Fabric SLA +body: Add a Release status section to the docs landing page indicating GA status, pointing to the release notes for the current version, and noting that the CLI may support Fabric items and rely on Fabric public APIs that are still in preview (and therefore not covered by the standard Fabric SLA) custom: Author: HasanAboShally From 904a22af9a222109dc45003a805b368423256dae Mon Sep 17 00:00:00 2001 From: Hasan Abo-Shally Date: Wed, 20 May 2026 18:32:17 +0300 Subject: [PATCH 4/4] docs: link Microsoft Fabric SLA explicitly --- docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index c56c10db2..396ee0bcf 100644 --- a/docs/index.md +++ b/docs/index.md @@ -31,7 +31,7 @@ Get powerful control over your Fabric resources: The Fabric CLI is generally available (GA). For the current version and changelog, see the [release notes](./release-notes.md). Run `fab --version` to check your installed version. -**Note:** The CLI may support Fabric items that are still in preview, and some commands may rely on Fabric public APIs that are still in [preview](https://learn.microsoft.com/rest/api/fabric/articles/api-structure#api-endpoints). Preview items and APIs aren't covered by the standard Fabric SLA. +**Note:** The CLI may support Fabric items that are still in preview, and some commands may rely on Fabric public APIs that are still in [preview](https://learn.microsoft.com/rest/api/fabric/articles/api-structure#api-endpoints). Preview items and APIs aren't covered by the [Microsoft Fabric SLA](https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services). ## Get started