diff --git a/docs/api-examples.md b/docs/api-examples.md
index 2496993..42ebb1d 100644
--- a/docs/api-examples.md
+++ b/docs/api-examples.md
@@ -34,9 +34,9 @@ soul -d ./Chinook_Sqlite.sqlite -p 8000
 ## Namespaces
 
 1. [/api/tables/](api/tables-examples.md) Examples for Tables endpoints
-2. [/api/<table-name>/rows/](api/rows-examples.md) Examples for Rows endpoints
+2. [/api/{table-name}/rows/](api/rows-examples.md) Examples for Rows endpoints
 3. [/api/auth/](api/auth-examples.md) Examples for Authentication / Authorization endpoints
-   1. [/api/<table-name>/rows/](api/rows-auth-examples.md) Examples for Rows endpoints in Auth mode
+   1. [/api/{table-name}/rows/](api/rows-auth-examples.md) Examples for Rows endpoints in Auth mode
 4. [/api/](api/root-examples.md) Examples for Root endpoints
 
 ## Handling Errors
diff --git a/docs/api/rows-auth-examples.md b/docs/api/rows-auth-examples.md
index f2ec859..425e17f 100644
--- a/docs/api/rows-auth-examples.md
+++ b/docs/api/rows-auth-examples.md
@@ -40,7 +40,7 @@ Response
 
 Only super users (e.g. `is_superuser=true`) or those with roles that have access to '\_roles' table can grant access to other users.
 
-> Head over to [README](/README.md) and _Updating Super Users_ section to learn how to promote someone to a super user.
+> Head over to [README, _Updating Super Users_ section](/README.md#3-updating-super-users) to learn how to promote someone to a super user.
 
 #### 2.1. Create a new Role