Structure examples according to documentation

- add some missing examples
- fix documentation links in examples
- change development status to stable

Author: mrbean-bremen

CHANGELOG.md

@@ -0,0 +1,3 @@
+This directory contains the example code as used in the documentation.
+Each example contains a link to the related documentation chapter.
+Refer to that documentation for usage.

README.md

@@ -1,6 +1,5 @@
-"""Test showing that sorting is not done if it would break an existing
-dependency.
-See https://pytest-order.readthedocs.io/en/stable/#order-dependencies
+"""Test showing that sorting is not done if it would break an existing dependency.
+See https://pytest-order.readthedocs.io/en/stable/configuration.html#order-dependencies
 """
 
 import pytest

docs/source/usage.rst

@@ -1,5 +1,5 @@
 """Test showing the behavior of the --order-dependencies option.
-See https://pytest-order.readthedocs.io/en/stable/#order-dependencies
+See https://pytest-order.readthedocs.io/en/stable/configuration.html#order-dependencies
 """
 
 import pytest

example/README

@@ -0,0 +1,14 @@
+"""One of the test files showing the use of the --order-group-scope option.
+See https://pytest-order.readthedocs.io/en/stable/configuration.html#order-group-scope
+"""
+
+import pytest
+
+
+@pytest.mark.order(2)
+def test1():
+    pass
+
+
+def test2():
+    pass

example/__init__.py renamed to example/configuration/order_dependencies/__init__.py

@@ -0,0 +1,14 @@
+"""One of the test files showing the use of the --order-group-scope option.
+See https://pytest-order.readthedocs.io/en/stable/configuration.html#order-group-scope
+"""
+
+import pytest
+
+
+@pytest.mark.order(1)
+def test1():
+    pass
+
+
+def test2():
+    pass