Skip to content

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

@Different2day

Description

@Different2day

@kakinney, @brianelton

  1. 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

External resource: https://diataxis.fr/

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/.

  1. 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions