Add simplest scenario example to Readme

CHANGES.rst

@@ -68,9 +68,11 @@ Unreleased
 ----------
 - Implement support of `Markdown <https://github.com/cucumber/gherkin/blob/main/MARKDOWN_WITH_GHERKIN.md>`_ using js based parser
 - Update versions:
+
  - Drop python 3.8
  - Add python 3.13
  - Drop pytest<5.2
+
 - Added dummy html reporter
 - Fixed pytest.ini option "disable_feature_autoload"
 - Improved fixture injection by adding seamless fixtures on plugin/module collection

README.rst

@@ -93,21 +93,28 @@ Install pytest-bdd-ng
 
     pip install pytest-bdd-ng
 
-Install extra packages for parsing Markdown defined features
-############################################################
+Packages for parsing Markdown defined features
+##############################################
 
 .. code-block:: console
 
     npm install @cucumber/gherkin
 
-Install extra packages for reporting
+Packages for reporting
 ####################################
 
 .. code-block:: console
 
     npm install @cucumber/html-formatter
 
 
+TLDR;
+-----
+
+.. include:: ../features/Feature/Load/Simple.feature
+   :code: gherkin
+
+
 Project layout
 --------------
 **pytest-bdd-ng** automatically collects ``*.feature`` files from pytest_ tests directory.

docs/include.rst

@@ -2,5 +2,5 @@
 .. include:: features.rst
 .. include:: ../DOCUMENTATION.rst
 .. include:: ../AUTHORS.rst
-.. include:: ../CHANGES.rst
 .. include:: ../LICENSE.rst
+.. include:: ../CHANGES.rst

features/Feature/Load/Simple.feature

@@ -0,0 +1,23 @@
+Feature: Simplest example
+  Scenario:
+    # https://cucumber.io/docs/gherkin/reference/
+    Given File "Passing.feature" with content:
+      """gherkin
+      Feature: Passing feature
+        Scenario: Passing scenario
+          * Passing step
+      """
+    # https://docs.pytest.org/en/stable/reference/fixtures.html#conftest-py-sharing-fixtures-across-multiple-files
+    And File "conftest.py" with content:
+      """python
+      from pytest_bdd import step
+
+      @step('Passing step')
+      def _():
+        ...
+      """
+    # https://docs.pytest.org/en/stable/how-to/usage.html
+    When run pytest
+    Then pytest outcome must contain tests with statuses:
+      |passed|
+      |     1|