matchers: doc imports required (#1549)

Author: MykolaGolubyev

webtau-docs/znai/matchers/any-of.md

@@ -9,12 +9,14 @@ Groovy:
     entry: "any of matcher example",
     bodyOnly: true
 }
+:include-markdown: import-ref.md
 
 Java: 
 :include-java: org/testingisdocumenting/webtau/MatchersTest.java {
     entry: "anyOfMatcherExample",
     bodyOnly: true
 } 
+:include-markdown: import-ref.md
 ```
 
 # Mixing Values And Matchers

webtau-docs/znai/matchers/any-value.md

@@ -8,11 +8,13 @@ Groovy:
 :include-file: org/testingisdocumenting/webtau/MatchersGroovyTest.groovy {
   surroundedBy: "any-value-table-example"
 } 
+:include-markdown: import-ref.md
 
 Java: 
 :include-file: org/testingisdocumenting/webtau/MatchersTest.java {
   surroundedBy: "any-value-table-example"
 } 
+:include-markdown: import-ref.md
 ```
 
 :include-cli-output: doc-artifacts/any-value-table-output.txt {

webtau-docs/znai/matchers/import-and-dependencies.md

@@ -0,0 +1,16 @@
+:include-markdown: imports/single-dsl-import.md
+
+# Matchers Specific Import
+
+To specifically import `matchers` only use
+
+```tabs
+Groovy:
+:include-file: org/testingisdocumenting/webtau/expectation/equality/handlers/StringMatchersGroovyExamplesTest.groovy {title: "matchers import", include: "Matchers.*"}
+:include-file: maven/core-dep.xml {title: "maven dependency"}
+
+Java:
+
+:include-file: org/testingisdocumenting/webtau/expectation/equality/handlers/StringMatchersJavaExamplesTest.java {title: "matchers import", include: "Matchers.*"} 
+:include-file: maven/core-dep.xml {title: "maven dependency"}
+```

webtau-docs/znai/matchers/import-ref.md

@@ -0,0 +1 @@
+Check [Import And Dependencies](matchers/import-and-dependencies) for prerequisites.

webtau-docs/znai/matchers/introduction.md

@@ -18,12 +18,15 @@ Groovy:
 
  Note: Groovy has a shortcut for `equal` matcher.
 
+:include-markdown: import-ref.md
+
 Java: 
 :include-file: org/testingisdocumenting/webtau/MatchersTest.java {
     title: "should example",
     surroundedBy: "string-string-example",
     commentsType: "remove"
 } 
+:include-markdown: import-ref.md
 ``` 
 
 :include-cli-output: doc-artifacts/string-string-comparison.txt {title: "should console output"}

webtau-docs/znai/matchers/java-beans-and-records.md

@@ -10,12 +10,14 @@ Groovy:
     surroundedBy: "bean-map-example",
     commentsType: "inline"
 }
+:include-markdown: import-ref.md
 
 Java: 
 :include-file: org/testingisdocumenting/webtau/MatchersTest.java {
     surroundedBy: "bean-map-example",
     commentsType: "inline"
 } 
+:include-markdown: import-ref.md
 ``` 
 
 ```columns

webtau-docs/znai/matchers/maps.md

@@ -7,10 +7,13 @@ Groovy:
 :include-file: org/testingisdocumenting/webtau/expectation/equality/handlers/MapMatchersGroovyExamplesTest.groovy {
   surroundedBy: "maps-equal-mismatch"
 }
+:include-markdown: import-ref.md
+
 Java:
 :include-file: org/testingisdocumenting/webtau/expectation/equality/handlers/MapMatchersJavaExamplesTest.java {
   surroundedBy: "maps-equal-mismatch"
 }
+:include-markdown: import-ref.md
 ```
 
 :include-cli-output: doc-artifacts/maps-equal-console-output.txt {

webtau-docs/znai/matchers/strings.md

@@ -7,11 +7,13 @@ Groovy:
 :include-file: org/testingisdocumenting/webtau/expectation/equality/handlers/StringMatchersGroovyExamplesTest.groovy {
   surroundedBy: "single-line-compare"
 }
+:include-markdown: import-ref.md
 
 Java:
 :include-file: org/testingisdocumenting/webtau/expectation/equality/handlers/StringMatchersJavaExamplesTest.java {
   surroundedBy: "single-line-compare"
 }
+:include-markdown: import-ref.md
 ```
 
 :include-cli-output: doc-artifacts/single-line-string-compare-output.txt {

webtau-docs/znai/matchers/tables.md

@@ -7,10 +7,13 @@ Groovy:
 :include-file: org/testingisdocumenting/webtau/expectation/equality/handlers/TableDataMatchersGroovyExamplesTest.groovy {
   surroundedBy: "table-equal-mismatch"
 }
+:include-markdown: import-ref.md
+
 Java:
 :include-file: org/testingisdocumenting/webtau/expectation/equality/handlers/TableDataMatchersJavaExamplesTest.java {
   surroundedBy: "table-equal-mismatch"
 }
+:include-markdown: import-ref.md
 ```
 
 :include-cli-output: doc-artifacts/table-equal-console-output.txt {

webtau-docs/znai/matchers/universal-compare.md

@@ -9,12 +9,14 @@ Groovy:
     surroundedBy: ["string-string-example", "string-number-example"], surroundedBySeparator: "",
     commentsType: "inline"
 }
+:include-markdown: import-ref.md
 
 Java: 
 :include-file: org/testingisdocumenting/webtau/MatchersTest.java {
     surroundedBy: ["string-string-example", "string-number-example"], surroundedBySeparator: "",
     commentsType: "inline"
 } 
+:include-markdown: import-ref.md
 ``` 
 
 # Reporting