diff --git a/docs/dev/basics.rst b/docs/dev/basics.rst
index 54febc30613f15950e47e98fa347e42e6667cd9d..2f4d1d89274e74c1c3c45532dba7c1cd77e0fe90 100644
--- a/docs/dev/basics.rst
+++ b/docs/dev/basics.rst
@@ -55,4 +55,11 @@ should be considered:
 
 - Is the script doing more than just executing external commands? if so, use lua
 - Is the script parsing/editing json-data? If so, use lua for speed
+- When using sh, use jsonfilter instead of json_* functions for speed
 
+Code formatting may sound like a topic for the pedantic, however it helps if
+the code in the project is formatted in the same way. The following rules
+apply:
+
+- use tabs instead of spaces
+- trailing whitespaces must be eliminated