3 ms·
> The most useful part of writing docs for me is that they shine a spotlight the sharp edges of your product. I love this. I have written docs for dev tools co
by mooreds 3y ago
> The most useful part of writing docs for me is that they shine a spotlight the sharp edges of your product.
I love this. I have written docs for dev tools companies and one section I love to write is the limitations section, especially if I am new to the product. This is helpful in so many ways.
* It lets me as a writer understand the built in limitations.
* It helps the team building the product get on the same page about areas to improve (or areas that are explicitly limited for business purposes)
* It helps with credibility for devs, as they can immediately determine if there a limitation that isa deal breaker.
The hard part is keeping it up to date, but that's true of most docs.