diff --git a/.yamllint b/.yamllint
index c5ae64bee9b61c675335a361715d2d8cbc7adda2..7c0f15cf782b192e2b80d4eadb9dcbf92b4553bf 100644
--- a/.yamllint
+++ b/.yamllint
@@ -1,4 +1,7 @@
 ---
+# based on documentation available at
+# https://yamllint.readthedocs.io/en/stable/rules.html
+
 extends: default
 
 rules:
@@ -8,5 +11,13 @@ rules:
   brackets:
     max-spaces-inside: 1
     level: error
+  comments:
+    min-spaces-from-content: 4
+  comments-indentation: disable
+  document-end: disable
+  document-start:
+    level: warning
+  octal-values:
+    forbid-explicit-octal: false
   line-length: disable
-  truthy: disable
+  truthy: enable