3 ms·
That process of you fumbling around and guessing is actually really extraordinarily helpful. The things a contributor might think to do or to try, and the thin
by AShedOfTools 10y ago
That process of you fumbling around and guessing is actually really extraordinarily helpful. The things a contributor might think to do or to try, and the things that a newcomer might think to do or to try, are completely different. No documentation survives its first encounter with a real newcomer. We can, and will, continue working on the onboarding experience, but we'll need real users to roll up their sleeves and wade into it, and the first few of them will have questions we didn't anticipate, and make assumptions we've never considered, and try use cases we've never thought of. Creating good documentation is something that newcomers and contributors need to collaborate on.
- bphogan 10y agoThat process is the second part of the process, once clear, basic documentation exists.