doc stuff

Author: atticus-sullivan

DOC.md

@@ -1071,9 +1071,16 @@ ls.add_snippets("all", {
   Contains everything from `conditions.show` as well.
 - `conditions`: Provides a function `make_condition(foo)` which takes a function
   as argument and returns a *condition object* for which several operators are
-  defined: `c1 + c2 -> c1 or c2`, `c1 * c2 -> c1 and c2`, `-c1 -> not c1`,
-  `c1 ^ c2 -> c1 xor/!= c2`, `c1 % c2 -> c1 xnor/== c2`. Thus you can easily
-  combine existing predicats. Like in
+  defined:
+  - `c1 + c2 -> c1 or c2`
+  - `c1 * c2 -> c1 and c2`
+  - `-c1 -> not c1`
+  - `c1 ^ c2 -> c1 xor/!= c2`
+  - `c1 % c2 -> c1 xnor/== c2`: This decision may look weird but as we weren't
+	able to use `==`, we decided to take something that makes one scratch ones
+	head (and thus avoid making false assumptions). For more details look at
+	[this comment](https://github.com/L3MON4D3/LuaSnip/pull/612#issuecomment-1264487743)
+  Thus you can easily combine existing predicats. Like in
   `conditions.expand.line_end + conditions.expand.line_begin` instead of doing
   something like
   `function(...) return conditions.expand.line_end(...) or conditions.expand.line_begin(...) end`.