New issue 432: Testing docs and doc tests
https://bitbucket.org/hpk42/pytest/issue/432/testing-docs-and-doc-tests

Piotr Banaszkiewicz:

Testing docs with tox right now requires `make`. Not everyone has it installed.
(And `regen` target for tox doesn't work, too)

I propose to expand testing docs and doctests so that:

1. rst syntax in docstrings is checked
2. `make` is no longed needed
3. doc trees are shared per tox env. run
4. `rm -rf` is not needed ([lets not repeat other projects' 
mistakes](https://github.com/MrMEEE/bumblebee-Old-and-abbandoned/commit/a047be85247755cdbe0acce6f1dafc8beb84f2ac#diff-3fbb47e318cd8802bd325e7da9aaabe8L351))
5. Sphinx is more strict about warnings (`-W`)

I'm ready to submit a pull request if you agree.

I would also like to somehow force developers to write docs about implemented 
new features or changed pytest behavior.


_______________________________________________
pytest-commit mailing list
pytest-commit@python.org
https://mail.python.org/mailman/listinfo/pytest-commit

Reply via email to