Adding upstream version 6.13.1.upstream/6.13.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 32 insertions, 0 deletions

diff --git a/src/ansiblelint/rules/deprecated_command_syntax.md b/src/ansiblelint/rules/deprecated_command_syntax.md
new file mode 100644
index 0000000..f99ca99
--- /dev/null
+++ b/src/ansiblelint/rules/deprecated_command_syntax.md
@@ -0,0 +1,32 @@
+# deprecated-command-syntax
+
+This rule identifies the use of shorthand (free-form) syntax as this is highly
+discouraged inside playbooks, mainly because it can easily lead to bugs that
+are hard to identify.
+
+While using the free-form from the command line is ok, it should never be used
+inside playbooks.
+
+## Problematic Code
+
+```yaml
+---
+- name: Example playbook
+  hosts: localhost
+  tasks:
+    - name: Perform chmod
+      ansible.builtin.command: creates=B chmod 644 A # <-- do not use shorthand
+```
+
+## Correct Code
+
+```yaml
+---
+- name: Example playbook
+  hosts: localhost
+  tasks:
+    - name: Perform chmod
+      ansible.builtin.command: chmod 644 A
+      args:
+        creates: B
+```