diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2be02243..5259375f 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -70,9 +70,23 @@ In our documentation source, the page is defined by [features.rst](https://githu
 ./scrape_docs.py -o csv https://element-hq.github.io/synapse/latest/admin_api/rooms.html
 ```
 
-which prints a two-column CSV table containing restructuredText formatted hyperlinks in the left column. A corresponding `synadm` command is supposed to be added to the right column manually.
+which prints a two-column CSV table containing restructuredText formatted hyperlinks in the left column. A corresponding `synadm` command is supposed to be added to the right hand side column manually. For example, you could add the following:
+
+```
+:option:`synadm user details USER_ID`
+```
+
+This would directly link to the USER_ID argument's documentation of that command.
+Linking to an option is also possible:
+
+```
+:option:`synadm media list -r`
+```
+
+Due to a shortcoming of Sphinx it is currently not possible to link to a plain command (without any option or argument).
+
+Also see `scrape_docs.py --help` and the [existing CSV files](https://github.com/JOJ0/synadm/tree/master/doc/source/features).
 
-For more information see `scrape_docs.py --help` and the [existing CSV files](https://github.com/JOJ0/synadm/tree/master/doc/source/features).
 
 ## Discuss & Design First