I always found the pytest docs quite hard to navigate - and because of someone with the same issue in IRC just now I realized why: The stuff which is probably most relevant (assert.rst and fixture.rst) is hidden on examples.rst but not mentioned at all in content.rst.

Some other stuff in content.rst is probably not that relevant... I think the whole thing should have some reorganization.

I'll take a look in a few weeks (still have a growing todo list), but if someone else wants to pick this up, please go ahead!