search

kubewarden / docs

Kubewarden's documentation
https://docs.kubewarden.io
Creative Commons Attribution 4.0 International
13 stars 23 forks source link

Information architecture experimentation. #348

Closed jhkrug closed 5 months ago

jhkrug commented 8 months ago

DO NOT MERGE. Experiment only.

See if this is going to be a useful direction for us.

Trying ideas in the docs to allow exploration of the structure of the docs so a learning path can be plotted by a user (the personas) of the docs.

To have ways apart from the Diataxis sidebar layout to navigate the docs. By persona, by topic, etc. To provide exploration and learning paths.

The idea would be that the entire 'Documentation architecture' hierarchy and content can be programmatically generated. But it can be much simpler than that. What provides the best value solution?

Please take a look at the preview.

https://deploy-preview-348--silly-bunny-8cedd0.netlify.app/next/info-arch/ia

netlify[bot] commented 8 months ago

Deploy Preview for silly-bunny-8cedd0 ready!

Name Link
Latest commit 6b54cadf739bc7527f1c2965cfd929c870ca9fcf
Latest deploy log https://app.netlify.com/sites/silly-bunny-8cedd0/deploys/65bcb5fcbfd52d0008a26ec4
Deploy Preview https://deploy-preview-348--silly-bunny-8cedd0.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

jhkrug commented 8 months ago

Leaving this with no status for a while. I will use some aspects of this again after the /docs reorg/new sidebar/ is complete.

jhkrug commented 5 months ago

Closing this now. A new task #400 is created to carry persona paths forward. A glossary is being experimented with in #394.