My least favourite kind of OSS homepage is for *nix CLI tools that always say something suspiciously close to "If you're here, you already know what you're looking at and what it's for."
Working on the docs for StimulusReflex and CableReady could be a full-time job if I let it be... but it's also so worth it. Our documentation and support is driving our adoption. It's the best marketing we have.
I try to take inspiration from the Diataxis project; we're working towards it as an ideal. Our docs still can occasionally feel like all things to all people.
One thing I believe is that video is an under-appreciated mechanism for both onboarding and explaining. Frankly, there's a lot of folks who just won't read... but they'll watch a 90 second video.
The other thing I can say for sure is that running a really attentive and welcoming Discord server gives us an opportunity to get to know the folks who might otherwise bounce. Every issue that comes up makes it into the docs in some form or another. It's a loop/cycle of support->documentation that makes the whole thing take on a life of its own.
For further actions, you may consider blocking this person and/or reporting abuse
We're a place where coders share, stay up-to-date and grow their careers.
My least favourite kind of OSS homepage is for *nix CLI tools that always say something suspiciously close to "If you're here, you already know what you're looking at and what it's for."
Working on the docs for StimulusReflex and CableReady could be a full-time job if I let it be... but it's also so worth it. Our documentation and support is driving our adoption. It's the best marketing we have.
I try to take inspiration from the Diataxis project; we're working towards it as an ideal. Our docs still can occasionally feel like all things to all people.
One thing I believe is that video is an under-appreciated mechanism for both onboarding and explaining. Frankly, there's a lot of folks who just won't read... but they'll watch a 90 second video.
The other thing I can say for sure is that running a really attentive and welcoming Discord server gives us an opportunity to get to know the folks who might otherwise bounce. Every issue that comes up makes it into the docs in some form or another. It's a loop/cycle of support->documentation that makes the whole thing take on a life of its own.