1 files changed, 32 insertions, 0 deletions
diff --git a/src/ansiblelint/rules/deprecated_bare_vars.md b/src/ansiblelint/rules/deprecated_bare_vars.md
new file mode 100644
index 0000000..9e2f15b
--- /dev/null
+++ b/src/ansiblelint/rules/deprecated_bare_vars.md
@@ -0,0 +1,32 @@
+# deprecated-bare-vars
+
+This rule identifies possible confusing expressions where it is not clear if
+a variable or string is to be used and asks for clarification.
+
+You should either use the full variable syntax ('{{{{ {0} }}}}') or, whenever
+possible, convert it to a list of strings.
+
+## Problematic code
+
+```yaml
+---
+- ansible.builtin.debug:
+    msg: "{{ item }}"
+  with_items: foo # <-- deprecated-bare-vars
+```
+
+## Correct code
+
+```yaml
+---
+# if foo is not really a variable:
+- ansible.builtin.debug:
+    msg: "{{ item }}"
+  with_items:
+    - foo
+
+# if foo is a variable:
+- ansible.builtin.debug:
+    msg: "{{ item }}"
+  with_items: "{{ foo }}"
+```