Doctests with Pytest

[alecandido]

Pytest supports doctests.
https://docs.pytest.org/en/stable/how-to/doctest.html#doctest

Thus, there is no reason to keep a separate step for executing doctests, relying on a different infrastructure (Sphinx itself) and even requiring an additional system dependency (Pandoc).

workflows/actions/poetry/test/action.yaml

Lines 25 to 33 in e443939

	- name: Test documentation examples
	shell: bash
	if: inputs.doctests != 'false'
	run: |
	sudo apt install pandoc
	eval $(poetry env activate)
	poe test-docs || make -C doc doctest # TODO: both commands are kept, to
	# preserve backwards compatibility,
	# remove in next breaking change