From 99fd6b0d04f79c36cbbf76213cc475a9ca1b76bc Mon Sep 17 00:00:00 2001
From: Sayan Nandan <nandansayan@outlook.com>
Date: Mon, 8 Apr 2024 09:56:49 +0000
Subject: [PATCH] sysadmin: Fix docs on user management (DCL)

---
 docs/blueql/4.dcl.md             |  6 +++---
 docs/system/2.user-management.md | 14 ++++++++++++--
 2 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/docs/blueql/4.dcl.md b/docs/blueql/4.dcl.md
index 91d9ac58f..7abe8c834 100644
--- a/docs/blueql/4.dcl.md
+++ b/docs/blueql/4.dcl.md
@@ -21,7 +21,7 @@ SYSCTL REPORT STATUS
 
 **Syntax**:
 ```sql
-SYSCTL CREATE USER 'username' WITH { password: 'password' }
+SYSCTL CREATE USER <username> WITH { password: 'password' }
 ```
 - **Access control**: `root` only
 - **Returns**: empty or error
@@ -30,7 +30,7 @@ SYSCTL CREATE USER 'username' WITH { password: 'password' }
 
 **Syntax**:
 ```sql
-SYSCTL ALTER USER 'username' WITH { password: 'new password' }
+SYSCTL ALTER USER <username> WITH { password: 'new password' }
 ```
 
 - **Access control**: `root` only
@@ -45,7 +45,7 @@ Trying to change the `root` account password will throw an error. You can only c
 
 **Syntax**:
 ```sql
-SYSCTL DROP USER 'username'
+SYSCTL DROP USER <username>
 ```
 - **Access control**: `root` only
 - **Returns**: empty or error
diff --git a/docs/system/2.user-management.md b/docs/system/2.user-management.md
index f1bdee7a1..f2617a4ac 100644
--- a/docs/system/2.user-management.md
+++ b/docs/system/2.user-management.md
@@ -35,9 +35,19 @@ what you intended, you can safely ignore it.
 
 You can have any number of standard users. Standard users can essentially manipulate data but can't modify the objects that store them.
 
-#### Changing account passwords
+#### Creating user accounts
 
-To change the password for a given account, you can follow the [instructions on BlueQL's DCL guide here](/blueql/dcl#sysctl-alter-user).
+To create an user account, run the following BlueQL query:
+
+```sql
+SYSCTL CREATE USER <username> WITH { password: 'password' }
+```
+
+Read more about [creating users here](/blueql/dcl#sysctl-create-user).
+
+#### Updating and removing user accounts
+
+To remove or update an account, you can follow the [instructions on BlueQL's DCL guide here](/blueql/dcl).
 
 #### Rights