Add menus of items for different audiences

Author: pfctdayelise

doc/en/new-docs/advanceduser.rst

@@ -0,0 +1,47 @@
+.. _`advanceduser`:
+
+Advanced User
+=============
+
+* Plugin recommendations
+* conftest.py
+* .ini config
+* Adding extra functionality to marks
+* Advanced parametrize
+
+
+More on fixtures:
+
+* Defining fixture scope
+* Parametrized fixtures
+
+
+Test suite speed:
+
+* Running tests in parallel
+* Profiling slow tests
+
+
+Integrating testing into development:
+
+* Testing against multiple Python interpreters with Tox
+* Continuous integration (CI) systems
+* Test coverage
+* Debugging
+* Python warnings
+* Logging
+* Flaky tests
+
+
+Different styles of testing:
+
+* Mock
+* GUI testing
+* Web browser testing
+* Running unittest/nose tests
+* Migrating from unittest to pytest
+* Migrating from nose to pytest
+* Running non-Python tests
+* Running doctests
+* Behaviour-driven development (BDD) style tests
+* Property-based testing (such as Hypothesis)

doc/en/new-docs/contributor.rst

@@ -0,0 +1,12 @@
+.. _`contributor`:
+
+Contributor
+===========
+
+* Setting up a development environment
+* Contribution suggestions
+* Git branch guide
+* Preparing a pull request
+* Project organisation
+* Pytest history
+* Projects that use pytest

doc/en/new-docs/index.rst

@@ -36,26 +36,48 @@ If you get an error checkout :ref:`installation issues`.
 Audiences
 ---------
 
+
 User
 ~~~~
 
 This section covers the basics to get you running and writing automated tests
 in pytest.
 
+:ref:`user`
+
+
 Advanced User
 ~~~~~~~~~~~~~
 
 This section dives deeper into pytest features such as fixtures and
 parametrization, how to extend pytest through hooks and gives advice on
 different styles of testing.
 
+:ref:`advanceduser`
+
+
 Plugin Author
 ~~~~~~~~~~~~~
 
 This section guides you in creating plugins to customize and extend pytest.
 
+:ref:`pluginauthor`
+
+
 Contributor
 ~~~~~~~~~~~
 
 If you are interested in contributing to pytest, this section will point you in
 the right direction.
+
+:ref:`contributor`
+
+
+
+References
+----------
+
+* Command-line options
+* Pytest namespace
+* Hooks
+* Built-in fixtures

doc/en/new-docs/pluginauthor.rst

@@ -0,0 +1,12 @@
+.. _`pluginauthor`:
+
+Plugin Author
+=============
+
+* Get started with the Cookiecutter template
+* Introduction to hooks
+* Registering a plugin with pytest (setup.py)
+* Recommended practice for publishing (moving to pytest-dev)
+* Adding a command-line option
+* Testing plugins
+* Using the pytest cache

doc/en/new-docs/user.rst

@@ -0,0 +1,29 @@
+.. _`user`:
+
+User
+====
+
+Writing tests
+-------------
+
+* Assert statements
+* Test naming conventions and discovery
+* Test directory structure
+* Asserting about exceptions with pytest.raises
+* Using pytest.mark to group tests
+* Skip and skipif marks
+* xfail mark
+* parametrize basics
+* Fixture basics
+* Fixture finalizers
+* Monkeypatch fixture
+
+
+Running tests
+-------------
+
+* Most useful command-line options
+* IDE integration
+* Types of test results
+* Stdout capturing
+* What happens when you press Ctrl-C?