feature request: implement diataxis

[jcstein]

https://diataxis.fr/

[Mackenzie-OO7]

@jcstein is this open to work on too? also, concerning the organization, do you have anything in mind?

[jcstein]

assigning myself to work on this one! thank you 😄

[jcstein]

unless you go for it first, but it will be a biiiiiig overhaul

[Mackenzie-OO7]

assigning myself to work on this one! thank you 😄

cool. but i’d still like to assist you, if you don’t mind👀

[jcstein]

sounds good!

here's what I'm thinking for categories:

• Learn (as it exists)
• How to (how to run a node, run op stack, etc.)
• Tutorials (node API tutorials mainly, etc.)
• Reference (all existing references, broken down by software)

how do you think that aligns with diataxis and what suggestions do you have based on the model on diataxis?

[Mackenzie-OO7]

looks good to me. i think it may be helpful to add a sub-section in the learn category that contains the existing overviews of the different modular stack integrations (op, arbitrum, sovereign, others) then include a link to their respective how-to guides.

what do you think?

[jcstein]

trying to keep things as minimal as possible so i think integrations belong in how-to-run-X

[Mackenzie-OO7]

I'll arrange this in a Miro mind map and share

[Mackenzie-OO7]

I'll arrange this in a Miro mind map and share

[jcstein]

this looks like a great start to me! thank you for putting this together

[Mackenzie-OO7]

this looks like a great start to me! thank you for putting this together

ty! can I make a draft pr implementing this organization?

[jcstein]

sure thing! I would be glad to review that.