On Sat, Jul 15, 2017, Daniele Procida <dani...@vurt.org> wrote: >I propose to restructure the pytest docmentation, according to this >scheme <https://divio.com/blog/documentation> (the rationale for the >scheme is described at length in that article).
Hi. I have made a start on this since I first mentioned it at EuroPython. You can see the work so far at <https://github.com/pytest-dev/pytest/compare/master...evildmp:documentation-restructure?expand=1> To try it out locally: Clone my branch and get into the right directory: git clone -b documentation-restructure g...@github.com:evildmp/pytest.git cd pytest/doc/en Set up the virtualenv for the docs: make install Start the documentation server: make run Checkout the new documentation at <http://localhost:8001>. Please note that there remains a lot more to do, but there is enough so far to get an idea of: * how it will be structured * what it will like I have many questions, which are in issues on my fork: <https://github.com/evildmp/pytest/issues/>. Because commits land so fast in master (over 200 since I started working on this less than a month ago) it would be good to get some feedback on this and know whether this approach is going to be accepted into pytest. If so, I will be able to continue, with two main tasks: * build Brianna's tutorial into the documentation * work through every single page and ensure that all content is correctly placed in the appropriate section. Thanks, Daniele _______________________________________________ pytest-dev mailing list pytest-dev@python.org https://mail.python.org/mailman/listinfo/pytest-dev