Adopting the Diátaxis framework for Python documentation

Here’s an attempt!

North Star for docs.python.org

People visit our documentation for four main reasons:

  • to learn, via tutorials
  • to accomplish a task, via how-to guides
  • to understand, via explanations
  • for information, via references

Let’s incrementally improve our docs in these areas, mindful of each target audience, following the advice at https://diataxis.fr

6 Likes