docs-community icon indicating copy to clipboard operation
docs-community copied to clipboard

Diátaxis: Where are we?

Open encukou opened this issue 2 years ago • 5 comments

There seems to be general consensus that diátaxis is a great theoretical model for structuring documentation. However, using it – restructuring Python's docs – is a monumental task that needs some planning upfront. @AA-Turner mentioned on the recent meeting that it would be good to start by charting the starting point: where on the Diátaxis chart do individual sections of the docs fall? With that info we should be able to start planning where they should fall, and restructure/rewrite accordingly.

encukou avatar Mar 11 '22 14:03 encukou