Document isFeature() and doesFeatureMatch(..)

Author: badeball

docs/mixing-types.md

@@ -0,0 +1,37 @@
+# Mixing Cucumber and non-Cucumber specs
+
+Mixing Cucumber and non-Cucumber specs are supported. Cypress can be configured with `specPattern` to resolve multiple spec types as shown below.
+
+```js
+export default defineConfig({
+  e2e: {
+    specPattern: "**/*.{spec.js,feature}"
+  },
+});
+```
+
+Cucumber hooks, IE. `Before` and `After` as imported from `@badeball/cypress-cucumber-preprocessor`, are *only* run in Cucumber-type specs.
+
+You can determine spec-type in Cypress' own hooks using `isFeature()`, as shown below.
+
+```js
+import { isFeature } from "@badeball/cypress-cucumber-preprocessor";
+
+beforeEach(() => {
+  if (isFeature()) {
+    // This is only run for Cucumber-type specs.
+  }
+})
+```
+
+You can also created conditions based on tags using `doesFeatureMatch(..)`, as shown below.
+
+```js
+import { isFeature, doesFeatureMatch } from "@badeball/cypress-cucumber-preprocessor";
+
+beforeEach(() => {
+  if (isFeature() && doesFeatureMatch("@foobar")) {
+    // This is only run for Cucumber-type specs tagged with @foobar.
+  }
+})
+```

docs/readme.md

@@ -14,4 +14,5 @@
 * [Configuration](configuration.md)
 * [Test configuration](test-configuration.md)
 * [Diagnostics / dry run](diagnostics.md)
+* [Mixing Cucumber and non-Cucumber specs](mixing-types.md)
 * [Frequently asked questions](faq.md)