diff --git a/jenkins_jobs/modules/publishers.py b/jenkins_jobs/modules/publishers.py
index 519e3f7ad..22fba9ca2 100644
--- a/jenkins_jobs/modules/publishers.py
+++ b/jenkins_jobs/modules/publishers.py
@@ -1060,19 +1060,14 @@ def checkstyle(parser, xml_parent, data):
     :arg str defaultEncoding: encoding for parsing or showing files
      (empty will use platform default)
 
-    Example::
+    Example:
+
+    .. literalinclude::  /../../tests/publishers/fixtures/checkstyle001.yaml
+
+    Full example:
+
+    .. literalinclude::  /../../tests/publishers/fixtures/checkstyle002.yaml
 
-      publishers:
-        - checkstyle:
-            pattern: '**/checkstyle-result.xml'
-            healthy: 0
-            unHealthy: 100
-            healthThreshold: 'high'
-            thresholds:
-                unstable:
-                    totalHigh: 10
-                failed:
-                    totalHigh: 1
     """
     checkstyle = XML.SubElement(xml_parent,
                                 'hudson.plugins.checkstyle.'
diff --git a/tests/publishers/fixtures/checkstyle001.xml b/tests/publishers/fixtures/checkstyle001.xml
new file mode 100644
index 000000000..ac3edc2a2
--- /dev/null
+++ b/tests/publishers/fixtures/checkstyle001.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<project>
+  <publishers>
+    <hudson.plugins.checkstyle.CheckStylePublisher>
+      <healthy/>
+      <unHealthy>100</unHealthy>
+      <thresholdLimit>high</thresholdLimit>
+      <pluginName>[CHECKSTYLE] </pluginName>
+      <defaultEncoding/>
+      <canRunOnFailed>false</canRunOnFailed>
+      <useStableBuildAsReference>false</useStableBuildAsReference>
+      <useDeltaValues>false</useDeltaValues>
+      <thresholds>
+        <unstableTotalAll/>
+        <unstableTotalHigh>10</unstableTotalHigh>
+        <unstableTotalNormal/>
+        <unstableTotalLow/>
+        <failedTotalAll/>
+        <failedTotalHigh>1</failedTotalHigh>
+        <failedTotalNormal/>
+        <failedTotalLow/>
+      </thresholds>
+      <shouldDetectModules>false</shouldDetectModules>
+      <dontComputeNew>true</dontComputeNew>
+      <doNotResolveRelativePaths>false</doNotResolveRelativePaths>
+      <pattern>**/checkstyle-result.xml</pattern>
+    </hudson.plugins.checkstyle.CheckStylePublisher>
+  </publishers>
+</project>
diff --git a/tests/publishers/fixtures/checkstyle001.yaml b/tests/publishers/fixtures/checkstyle001.yaml
new file mode 100644
index 000000000..bbbf08e14
--- /dev/null
+++ b/tests/publishers/fixtures/checkstyle001.yaml
@@ -0,0 +1,11 @@
+publishers:
+ - checkstyle:
+    pattern: '**/checkstyle-result.xml'
+    healthy: 0
+    unHealthy: 100
+    healthThreshold: 'high'
+    thresholds:
+        unstable:
+            totalHigh: 10
+        failed:
+            totalHigh: 1
diff --git a/tests/publishers/fixtures/checkstyle002.xml b/tests/publishers/fixtures/checkstyle002.xml
new file mode 100644
index 000000000..29a1686cc
--- /dev/null
+++ b/tests/publishers/fixtures/checkstyle002.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<project>
+  <publishers>
+    <hudson.plugins.checkstyle.CheckStylePublisher>
+      <healthy/>
+      <unHealthy>100</unHealthy>
+      <thresholdLimit>high</thresholdLimit>
+      <pluginName>[CHECKSTYLE] </pluginName>
+      <defaultEncoding>utf-8</defaultEncoding>
+      <canRunOnFailed>true</canRunOnFailed>
+      <useStableBuildAsReference>false</useStableBuildAsReference>
+      <useDeltaValues>false</useDeltaValues>
+      <thresholds>
+        <unstableTotalAll>90</unstableTotalAll>
+        <unstableTotalHigh>80</unstableTotalHigh>
+        <unstableTotalNormal>70</unstableTotalNormal>
+        <unstableTotalLow>60</unstableTotalLow>
+        <failedTotalAll>90</failedTotalAll>
+        <failedTotalHigh>80</failedTotalHigh>
+        <failedTotalNormal>70</failedTotalNormal>
+        <failedTotalLow>60</failedTotalLow>
+      </thresholds>
+      <shouldDetectModules>true</shouldDetectModules>
+      <dontComputeNew>true</dontComputeNew>
+      <doNotResolveRelativePaths>false</doNotResolveRelativePaths>
+      <pattern>**/checkstyle-result.xml</pattern>
+    </hudson.plugins.checkstyle.CheckStylePublisher>
+  </publishers>
+</project>
diff --git a/tests/publishers/fixtures/checkstyle002.yaml b/tests/publishers/fixtures/checkstyle002.yaml
new file mode 100644
index 000000000..1e45c25f6
--- /dev/null
+++ b/tests/publishers/fixtures/checkstyle002.yaml
@@ -0,0 +1,20 @@
+publishers:
+ - checkstyle:
+    pattern: '**/checkstyle-result.xml'
+    canRunOnFailed: true
+    shouldDetectModules: true
+    healthy: 0
+    unHealthy: 100
+    healthThreshold: 'high'
+    thresholds:
+        unstable:
+            totalAll: 90
+            totalHigh: 80
+            totalNormal: 70
+            totalLow: 60
+        failed:
+            totalAll: 90
+            totalHigh: 80
+            totalNormal: 70
+            totalLow: 60
+    defaultEncoding: 'utf-8'
diff --git a/tests/publishers/fixtures/checkstyle003.xml b/tests/publishers/fixtures/checkstyle003.xml
new file mode 100644
index 000000000..df211bb81
--- /dev/null
+++ b/tests/publishers/fixtures/checkstyle003.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<project>
+  <publishers>
+    <hudson.plugins.checkstyle.CheckStylePublisher>
+      <healthy/>
+      <unHealthy/>
+      <thresholdLimit>low</thresholdLimit>
+      <pluginName>[CHECKSTYLE] </pluginName>
+      <defaultEncoding/>
+      <canRunOnFailed>false</canRunOnFailed>
+      <useStableBuildAsReference>false</useStableBuildAsReference>
+      <useDeltaValues>false</useDeltaValues>
+      <thresholds>
+        <unstableTotalAll/>
+        <unstableTotalHigh/>
+        <unstableTotalNormal/>
+        <unstableTotalLow/>
+        <failedTotalAll/>
+        <failedTotalHigh/>
+        <failedTotalNormal/>
+        <failedTotalLow/>
+      </thresholds>
+      <shouldDetectModules>false</shouldDetectModules>
+      <dontComputeNew>true</dontComputeNew>
+      <doNotResolveRelativePaths>false</doNotResolveRelativePaths>
+      <pattern/>
+    </hudson.plugins.checkstyle.CheckStylePublisher>
+  </publishers>
+</project>
diff --git a/tests/publishers/fixtures/checkstyle003.yaml b/tests/publishers/fixtures/checkstyle003.yaml
new file mode 100644
index 000000000..24201cbbb
--- /dev/null
+++ b/tests/publishers/fixtures/checkstyle003.yaml
@@ -0,0 +1,2 @@
+publishers:
+  - checkstyle