diff --git a/docs/FunctionSignatures.md b/docs/FunctionSignatures.md
index bb275834eef73542260bd08791f6041689c31f09..6f4d27cb2fbbe1ee47235897f19243a6d33923ee 100644
--- a/docs/FunctionSignatures.md
+++ b/docs/FunctionSignatures.md
@@ -7,6 +7,15 @@
 -->
 
 
+<!-- 
+linkmagic: 
+ - the pointing link must be lowercase 
+ - for the name everything is fine
+ - only use one `#` even if the heading has more `####`
+e.g: 
+[Facncy Link Name](path/file/#fancy_link_name_all_lowercase)
+-->
+
 ```
 range(min, max)
 ```