3 ms·
The documentation section here applies to so many products I've battled in the past. > The command supabase db remote commit is documented as "Commit Remote Ch
by simonw 4y ago
The documentation section here applies to so many products I've battled in the past.
> The command supabase db remote commit is documented as "Commit Remote Changes As A New Migration". The command supabase functions new is documented as "Create A New Function Locally." The documentation page is beautiful, but the words in it just aren't finished.
Great documentation is such a force multiplier for a product. It's so worthwhile investing in this.
Don't make your most dedicated users (the ones who get as far as consulting your documentation) guess how to use your thing!
- kiwicopple 4y agothis is very fair criticism. We hired a Head of Docs in March. I hope the improvements are evident since he joined, both in content and in usability. We have a long way to go, but we're working on it.
- pluto_modadic 4y agoyeah, most golang/rust/API documentation in products seems to think that "the function name is documentation", which.... no it's not. that's a tooltip in an IDE, not a docs website.