diff --git a/docs/docs/cmd/entra/rolepermission/rolepermission-list.mdx b/docs/docs/cmd/entra/rolepermission/rolepermission-list.mdx
index 66fa7ae959..ad31b2923c 100644
--- a/docs/docs/cmd/entra/rolepermission/rolepermission-list.mdx
+++ b/docs/docs/cmd/entra/rolepermission/rolepermission-list.mdx
@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
 
 # entra rolepermission list
 
-Lists all Microsoft Entra ID role permissions.
+Lists all Microsoft Entra ID role permissions
 
 ## Usage
 
@@ -13,8 +13,9 @@ m365 entra rolepermission list [options]
 ```
 
 ## Options
+
 ```md definition-list
-`-n, resourceNamespace [resourceNamespace]`
+`-n, --resourceNamespace [resourceNamespace]`
 : The namespace of the resource for which to retrieve role permissions.
 
 `-p, --privileged`
@@ -26,9 +27,15 @@ m365 entra rolepermission list [options]
 
 <Global />
 
-## Examples
+## Remarks
+
+:::warning
 
-### Examples
+The command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+## Examples
 
 Get a list of role permissions
 
diff --git a/src/m365/entra/commands/rolepermission/rolepermission-list.ts b/src/m365/entra/commands/rolepermission/rolepermission-list.ts
index 8b90e7d060..b868c39d39 100644
--- a/src/m365/entra/commands/rolepermission/rolepermission-list.ts
+++ b/src/m365/entra/commands/rolepermission/rolepermission-list.ts
@@ -31,7 +31,7 @@ class EntraRolePermissionListCommand extends GraphCommand {
   }
 
   public get description(): string {
-    return 'Lists all Microsoft Entra ID role permissions from a specifi resource namespace';
+    return 'Lists all Microsoft Entra ID role permissions';
   }
 
   public defaultProperties(): string[] | undefined {
@@ -46,6 +46,7 @@ class EntraRolePermissionListCommand extends GraphCommand {
     if (this.verbose) {
       await logger.logToStderr('Getting Microsoft Entra ID role permissions...');
     }
+
     try {
       const queryParameters: string[] = [];