update docs

Signed-off-by: AnthonyTsu1984 <wenjia.tu@zilliz.com>

Author: AnthonyTsu1984

API_Reference/milvus-sdk-java/v2.6.x/v2/Authentication/alterRole.md

@@ -0,0 +1,52 @@
+# alterRole()
+
+This operation updates the description of an existing role.
+
+```java
+public void alterRole(AlterRoleReq request)
+```
+
+## Request Syntax
+
+```java
+client.alterRole(AlterRoleReq.builder()
+    .roleName(String roleName)
+    .description(String description)
+    .build()
+);
+```
+
+**BUILDER METHODS:**
+
+- `roleName(String roleName)`
+
+    **[REQUIRED]**
+
+    The name of the role to update.
+
+- `description(String description)`
+
+    The new description of the role. Use an empty string to clear the description.
+
+**RETURNS:**
+
+*void*
+
+This operation returns no value.
+
+**EXCEPTIONS:**
+
+- **MilvusClientException**
+
+    This exception will be raised when any error occurs during this operation.
+
+## Example
+
+```java
+import io.milvus.v2.service.rbac.request.AlterRoleReq;
+
+client.alterRole(AlterRoleReq.builder()
+    .roleName("analytics_reader")
+    .description("Grants read-only access to analytics collections")
+    .build());
+```

API_Reference/milvus-sdk-java/v2.6.x/v2/Authentication/createRole.md

@@ -1,6 +1,6 @@
 # createRole()
 
-This operation creates a custom role.
+This operation creates a role and optionally stores a description for that role.
 
 ```java
 public void createRole(CreateRoleReq request)
@@ -9,47 +9,44 @@ public void createRole(CreateRoleReq request)
 ## Request Syntax
 
 ```java
-createRole(CreateRoleReq.builder()
+client.createRole(CreateRoleReq.builder()
     .roleName(String roleName)
+    .description(String description)
     .build()
-)
+);
 ```
 
 **BUILDER METHODS:**
 
 - `roleName(String roleName)`
 
+    **[REQUIRED]**
+
     The name of the role to create.
 
+- `description(String description)`
+
+    An optional description of the role. Defaults to an empty string.
+
 **RETURNS:**
 
 *void*
 
+This operation returns no value.
+
 **EXCEPTIONS:**
 
-- **MilvusClientExceptions**
+- **MilvusClientException**
 
     This exception will be raised when any error occurs during this operation.
 
 ## Example
 
 ```java
-import io.milvus.v2.client.ConnectConfig;
-import io.milvus.v2.client.MilvusClientV2;
 import io.milvus.v2.service.rbac.request.CreateRoleReq;
 
-// 1. Set up a client
-ConnectConfig connectConfig = ConnectConfig.builder()
-        .uri("http://localhost:19530")
-        .token("root:Milvus")
-        .build();
-        
-MilvusClientV2 client = new MilvusClientV2(connectConfig);
-
-// 2. Create a role
-CreateRoleReq createRoleReq = CreateRoleReq.builder()
-        .roleName("read_only")
-        .build();
-        
-client.createRole(createRoleReq);
+client.createRole(CreateRoleReq.builder()
+    .roleName("analytics_reader")
+    .description("Grants read-only access to analytics collections")
+    .build());
 ```

API_Reference/milvus-sdk-java/v2.6.x/v2/Authentication/createUser.md

@@ -1,6 +1,6 @@
 # createUser()
 
-This operation creates a user.
+This operation creates a user and optionally stores a description for that user.
 
 ```java
 public void createUser(CreateUserReq request)
@@ -9,54 +9,52 @@ public void createUser(CreateUserReq request)
 ## Request Syntax
 
 ```java
-createUser(CreateUserReq.builder()
+client.createUser(CreateUserReq.builder()
     .userName(String userName)
     .password(String password)
+    .description(String description)
     .build()
-)
+);
 ```
 
 **BUILDER METHODS:**
 
-- `userName(String roleName)`
+- `userName(String userName)`
+
+    **[REQUIRED]**
 
     The name of the user to create.
 
 - `password(String password)`
 
-    The password of the user to create.
+    **[REQUIRED]**
+
+    The password for the user.
+
+- `description(String description)`
+
+    An optional description of the user. Defaults to an empty string.
 
 **RETURNS:**
 
 *void*
 
+This operation returns no value.
+
 **EXCEPTIONS:**
 
-- **MilvusClientExceptions**
+- **MilvusClientException**
 
     This exception will be raised when any error occurs during this operation.
 
 ## Example
 
 ```java
-import io.milvus.v2.client.ConnectConfig;
-import io.milvus.v2.client.MilvusClientV2;
 import io.milvus.v2.service.rbac.request.CreateUserReq;
 
-// 1. Set up a client
-ConnectConfig connectConfig = ConnectConfig.builder()
-        .uri("http://localhost:19530")
-        .token("root:Milvus")
-        .build();
-        
-MilvusClientV2 client = new MilvusClientV2(connectConfig);
-
-// 2. Create a user
-CreateUserReq createUserReq = CreateUserReq.builder()
-        .userName("test")
-        .password("Zilliz@2023")
-        .build();
-        
-client.createUser(createUserReq);
+client.createUser(CreateUserReq.builder()
+    .userName("analyst_user")
+    .password("P@ssw0rd!")
+    .description("Read-only analyst account")
+    .build());
 ```
-

API_Reference/milvus-sdk-java/v2.6.x/v2/Authentication/describeRole.md

@@ -1,6 +1,6 @@
 # describeRole()
 
-This operation describes a specific role.
+This operation returns the privileges granted to a role and the role description.
 
 ```java
 public DescribeRoleResp describeRole(DescribeRoleReq request)
@@ -9,72 +9,40 @@ public DescribeRoleResp describeRole(DescribeRoleReq request)
 ## Request Syntax
 
 ```java
-describeRole(DescribeRoleReq.builder()
+DescribeRoleResp resp = client.describeRole(DescribeRoleReq.builder()
     .roleName(String roleName)
-    .dbName(String dbName)
     .build()
-)
+);
 ```
 
 **BUILDER METHODS:**
 
 - `roleName(String roleName)`
 
-    The name of the role to describe.
-
-- `dbName(String dbName)`
-
-    The name of the database associated with the role.
+    **[REQUIRED]**
 
-**RETURN Type:**
-
-*DescribeRoleResp.GrantInfo*
+    The name of the role to describe.
 
 **RETURNS:**
 
-A **DescribeRoleResp.GrantInfo** object representing the permissions assigned to the role.
-
-**PARAMETERS:**
+*DescribeRoleResp*
 
-- **objectType** (*String*):
-The type of the object being granted a privilege.
-
-- **privilege** (*String*):
-The specific privilege granted to the object.
-
-- **objectName** (*String*):
-The name of the object to which the privilege is granted.
-
-- **dbName** (*String*):
-The name of the database associated with the granted privilege.
-
-- **grantor** (*String*):
-The name of the entity (user or role) that granted the privilege.
+The response contains `roleName`, `grantInfos`, and `description`.
 
 **EXCEPTIONS:**
 
-- **MilvusClientExceptions**
+- **MilvusClientException**
 
     This exception will be raised when any error occurs during this operation.
 
 ## Example
 
 ```java
-import io.milvus.v2.client.ConnectConfig;
-import io.milvus.v2.client.MilvusClientV2;
-import io.milvus.v2.service.rbac.request.DescribeUserReq;
-
-// 1. Set up a client
-ConnectConfig connectConfig = ConnectConfig.builder()
-        .uri("http://localhost:19530")
-        .token("root:Milvus")
-        .build();
-        
-MilvusClientV2 client = new MilvusClientV2(connectConfig);
-
-// 2. Describe a role
-DescribeRoleReq describeRoleReq = DescribeRoleReq.builder()
-        .roleName("test")
-        .build();
-client.describeRole(describeRoleReq);
+import io.milvus.v2.service.rbac.request.DescribeRoleReq;
+import io.milvus.v2.service.rbac.response.DescribeRoleResp;
+
+DescribeRoleResp resp = client.describeRole(DescribeRoleReq.builder()
+    .roleName("analytics_reader")
+    .build());
+System.out.println(resp.getDescription());
 ```

API_Reference/milvus-sdk-java/v2.6.x/v2/Authentication/describeUser.md

@@ -1,6 +1,6 @@
 # describeUser()
 
-This operation describes a specific user.
+This operation returns the roles assigned to a user and the user description.
 
 ```java
 public DescribeUserResp describeUser(DescribeUserReq request)
@@ -9,57 +9,40 @@ public DescribeUserResp describeUser(DescribeUserReq request)
 ## Request Syntax
 
 ```java
-describeUser(DescribeUserReq.builder()
+DescribeUserResp resp = client.describeUser(DescribeUserReq.builder()
     .userName(String userName)
     .build()
-)
+);
 ```
 
 **BUILDER METHODS:**
 
 - `userName(String userName)`
 
-    The name of the user to describe.
-
-**RETURN TYPE:**
+    **[REQUIRED]**
 
-*DescribeUserResp*
+    The name of the user to describe.
 
 **RETURNS:**
 
-A **DescribeUserResp** object containing the details of the user.
-
-**PARAMETERS:**
-
-- **roles** (*List\<String\>*) -
+*DescribeUserResp*
 
-    A list of role names associated with the user.
+The response contains `userName`, `roles`, and `description`.
 
 **EXCEPTIONS:**
 
-- **MilvusClientExceptions**
+- **MilvusClientException**
 
     This exception will be raised when any error occurs during this operation.
 
 ## Example
 
 ```java
-import io.milvus.v2.client.ConnectConfig;
-import io.milvus.v2.client.MilvusClientV2;
 import io.milvus.v2.service.rbac.request.DescribeUserReq;
+import io.milvus.v2.service.rbac.response.DescribeUserResp;
 
-// 1. Set up a client
-ConnectConfig connectConfig = ConnectConfig.builder()
-        .uri("http://localhost:19530")
-        .token("root:Milvus")
-        .build();
-        
-MilvusClientV2 client = new MilvusClientV2(connectConfig);
-
-// 2. Describe a user
-DescribeUserReq describeUserReq = DescribeUserReq.builder()
-        .userName("test")
-        .build();
-DescribeUserResp describeUserResp = client.describeUser(describeUserReq);
+DescribeUserResp resp = client.describeUser(DescribeUserReq.builder()
+    .userName("analyst_user")
+    .build());
+System.out.println(resp.getDescription());
 ```
-