jamilbk
Joined 15 years ago
Karma
731
Submissions
129
Member since
Apr 28
Joined 15 years ago
If you're embarking upon a refactoring / rewriting journey for your docs, the only advice I'd share is to actually read the website beginning to end before starting. Especially this page: https://diataxis.fr/complex-hierarchies/. The guide is (unsurprisingly) very well written, and it's easy to internalize the concepts because they're repeated often.
Two related contexts that I've found to be much more friendly for this:
1. Climbing gyms, for reasons mentioned previously
2. The sauna! Actually very ideal for convos with strangers. Max overlap time is ~15 minutes, people are generally relaxed, no phones to distract and if it doesn't go well either party can always leave.
https://www.github.com/firezone/firezone
Reach me: jamil AT firezone.dev
[ my public key: https://keybase.io/jamilbk; my proof: https://keybase.io/jamilbk/sigs/er-2zgQKQlBJEqbqmSFS2pxF01P8Hw5icoZ9WtUWxcE ]