Community Forum
How do you properly structure multi-step workflows in Ohyay docs?
Hi everyone, I’ve recently started working with Ohyay and have been going through the documentation to learn how to organize guides more clearly. I’m currently writing a tutorial that includes several steps, sub-steps, and some optional actions, and I’m not sure what the recommended structure is for keeping everything easy to read.
Is it better to keep everything in one long guide with headings for each step, or should larger workflows be split into multiple smaller pages and linked together? I’m also curious if there are best practices for adding notes, warnings, or tips without interrupting the flow of the instructions.
If anyone here has experience writing longer tutorials in Ohyay docs, I’d really appreciate hearing how you structure them so readers don’t get lost. Thanks!