[pytest-dev] Documentation proposal
nicoddemus at gmail.com
Mon Aug 7 12:07:15 EDT 2017
Thanks a lot for following up on this!
I've pushed your branch up to pytest's repository and enabled building it
on RTD so people can more easily take a look at it:
I did a quick glance and I like what I see so far. Having separate
tutorial/how-to guides/reference documents seems like a great improvement
because a common complain regarding pytest's docs was the fact that there
was no clear distinction between those different types of documentation.
>From my part I'm +1 on continue to work on this. :)
On Mon, Aug 7, 2017 at 2:50 AM Daniele Procida <daniele at vurt.org> wrote:
> On Sat, Jul 15, 2017, Daniele Procida <daniele at 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).
> I have made a start on this since I first mentioned it at EuroPython.
> You can see the work so far at <
> To try it out locally:
> Clone my branch and get into the right directory:
> git clone -b documentation-restructure git at github.com:
> 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: <
> 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.
> pytest-dev mailing list
> pytest-dev at python.org
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the pytest-dev