back
2 comments
I briefly clicked around and haven't read everything yet, but from a first impression, this looks pretty good.

Sadly it looks like the "Process" heading is just a stub, which is a bummer because that's one of the things I'm most looking forward to improving, and I'm guessing that's true for many. What I've found is that in my technical writing, often I just start writing and at some point the document becomes badly organized in a subtle way that's difficult for me to see, but then I do a big rewrite of sorts and it's much better the second time around.

yeah sorry the idea there is to move over stuff from our handbook like https://ritza.co/handbook/how-we-work/our-production-process... - but it's hard to separate what is specific to us and what is more generically useful so that is still a WIP.

I think it's hard to advise a process as it's quite personal. Some people write down bullet points and expand, others write and rewrite until it's what they want. I think we're far from having enough research to know if one way is 'better' than another or not, so for now we mainly just advise writing as much as possible (https://styleguide.ritza.co/improving-your-writing/how-do-I-...) and figuring out what works for you.

Structure is really hard so I don't have any easy answers for you there either, but https://styleguide.ritza.co/ritza%27s-writing-rules/Style/#k... talks a bit about how the writers job is to go through exactly what you're describing so that the reader doesn't have to.