[IDEA, EXTERNAL RESOURCE] Categorise education content into document types #35

Different2day · 2024-11-16T13:53:51Z

I wonder whether it would be helpful to check out the document types in the Diátaxis framework. The latter are:

tutorials
how-to guides
technical reference
explanation

We could

perhaps compare the document types on WAI with the Diátaxis doc types, and maybe categorise them into those groups
categorise educational material for young coders

I'm aware that you and most in the group are seasoned educators and authors.
Am sharing this simple technical documentation framework just in case it's in any way useful.

Complex hierarchies are mentioned at https://diataxis.fr/complex-hierarchies/.
The challenge looks familiar.

For context: this is where I came across the resource https://oboacademy.github.io/obook/.

Separate question: would you like us to add ideas and resource suggestions to an earlier github issue, or open a new one?

I opened a new one because this may be interesting for either project.
Also thought that smaller less-aggregated issues are perhaps easier to manage for you.

What works best for you?

Anya

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[IDEA, EXTERNAL RESOURCE] Categorise education content into document types #35

[IDEA, EXTERNAL RESOURCE] Categorise education content into document types #35

[IDEA, EXTERNAL RESOURCE] Categorise education content into document types #35

[IDEA, EXTERNAL RESOURCE] Categorise education content into document types #35

Comments

Uh oh!