From b002912c531bde5c7e7aecfd92780ab745f231b9 Mon Sep 17 00:00:00 2001
From: Robert Kaussow <mail@geeklabor.de>
Date: Thu, 8 Oct 2020 00:01:13 +0200
Subject: [PATCH] add documentation how to exclude tasks

---
 docs/content/configuration/excludes.md | 21 +++++++++++++++++++++
 docs/data/menu/main.yml                |  2 ++
 2 files changed, 23 insertions(+)
 create mode 100644 docs/content/configuration/excludes.md

diff --git a/docs/content/configuration/excludes.md b/docs/content/configuration/excludes.md
new file mode 100644
index 0000000..bac5817
--- /dev/null
+++ b/docs/content/configuration/excludes.md
@@ -0,0 +1,21 @@
+---
+title: Exclude tasks
+---
+
+If you want to ignore individual tasks completely, you can use the `skip_ansible_later` tag.
+
+## Example
+
+<!-- prettier-ignore-start -->
+<!-- spellchecker-disable -->
+<!-- markdownlint-disable -->
+{{< highlight Yaml "linenos=table" >}}
+- name: Excluded task
+  command: "pwd"
+  tags:
+    - skip_ansible_later
+
+{{< /highlight >}}
+<!-- markdownlint-restore -->
+<!-- spellchecker-enable -->
+<!-- prettier-ignore-end -->
diff --git a/docs/data/menu/main.yml b/docs/data/menu/main.yml
index e1e2a0d..d3b79b2 100644
--- a/docs/data/menu/main.yml
+++ b/docs/data/menu/main.yml
@@ -13,6 +13,8 @@ main:
         ref: "/configuration/defaults"
       - name: CLI options
         ref: "/configuration/cli"
+      - name: Exclude tasks
+        ref: "/configuration/excludes"
   - name: Usage
     ref: "/usage"
   - name: Included rules