Breakout "Learn" area of the website, or integrate into tidalcycles.org?

[jarmitage]

Currently we have /tutorial which is a mix of tutorial and reference, and an experimental workshop branch

What would be ideal in terms of developing this further? E.g. there could be a sitemap like:

strudel.tidalcycles.org/learn/get-started
strudel.tidalcycles.org/learn/tutorial
strudel.tidalcycles.org/learn/workshop
strudel.tidalcycles.org/learn/[topic]
strudel.tidalcycles.org/learn/reference

Another thing to consider, should there be some mirroring going on structurally between Strudel docs and https://tidalcycles.org/docs/?

[jarmitage]

Currently /tutorial and /workshop do not have a router for different subpages. @felixroos mentioned Astro as a possibility.

Should Strudel move to a doc system with search like https://tidalcycles.org/docs/? Would it be possible to even integrate different Tidal dialects into one doc system?

[jarmitage]

Related:

• Embedding strudel #103
• Strudel Workshop #81
• brainstorm on pattern sharing #55

[felixroos]

Currently /tutorial and /workshop do not have a router for different subpages. @felixroos mentioned Astro as a possibility.

I started this with #315

Should Strudel move to a doc system with search like https://tidalcycles.org/docs/?

The above PR is based on https://github.com/withastro/astro/tree/latest/examples/docs which is an alternative to the omnipresent docusaurus. It also supports algolia + should perform better + some other cool things

Would it be possible to even integrate different Tidal dialects into one doc system?

So far, we have no grammar for tidal syntax that can be translated into strudel code, but it would certainly be nice. It could be implemented with peggy too. vortex could potentially also run in the browser but i am not too deep into python to do that.

Another thing to consider, should there be some mirroring going on structurally between Strudel docs and https://tidalcycles.org/docs/?

At this point in time I would say it's good if strudel continues to have its own docs, but reusing parts from the tidal docs makes sense. If we have a tidal grammar, it could make sense to integrate a mini repl with it into the main tidal docs.

What would be ideal in terms of developing this further? E.g. there could be a sitemap like...

If you want, you can help me rearrange the docs into multiple pages. I'd only make sure /tutorial is still reachable, as it's already linked at a handful of external sites

[felixroos]

maybe this is a neat alternative for algolia: https://docs.lyrasearch.io/ / https://docs.lyrasearch.io/plugins/plugin-system/astro-plugin

[jarmitage]

Documenting an idea from the chat:

'Learn' sidebar could pop out in the main REPL.

It could also mimic the Quick Help feature of DAWs, by showing the documentation corresponding to the cursor location

[felixroos]

related: #783