Re:Gatsby raises $28M Series B led by Index Ventures
by gk1 on Wednesday May 27, 2020 @12:51PM
(#23326099)
Can't tell if that's sarcasm or not. I've 100% seen startups lose prospects and deals because the docs weren't great.
If anyone who's selling software thinks their docs are only for users, and don't get read by prospective customers, they're missing out on customer prospects without even realizing. Many people even skip the homepage and everything else and jump straight to the docs to figure out what the product does, whom it's for, how it works, what it integrates with, and so on.
Re:Gatsby raises $28M Series B led by Index Ventures
by ritchiea on Wednesday May 27, 2020 @12:58PM
(#23326223)
Good documentation is immensely valuable. Likely an absolute must have to be a huge ecosystem like node, rails, etc. But extensive documentation certainly can't replace being a simple, well organized and elegant tool for the job. Last I checked the Gatsby docs felt more complete than the Next.js docs. Writing this out makes me want to head over to to the Next.js repo and start contributing.
Re:Gatsby raises $28M Series B led by Index Ventures
by hckr_news on Wednesday May 27, 2020 @01:40PM
(#23326915)
If I recall correctly that’s what Patrick Collison said about one of the reasons why Stripe grew so quick as they had such useful docs. Good, robust documentation is crucial for any software project or business.
Re:Gatsby raises $28M Series B led by Index Ventures
by cyral on Wednesday May 27, 2020 @07:45PM
(#23331613)
I can totally see why. Stripe’s docs are really the best I’ve seen. Not only are the docs good but the API is very logical and well made, definitely much better than their competitors like Authorize.Net.
Re:Gatsby raises $28M Series B led by Index Ventures
by rpastuszak on Wednesday May 27, 2020 @02:08PM
(#23327331)
+1 also, well maintained/pretty docs are often a sign that the project was done without a rush.
I think you might be on to something; I don't even bother with projects without good docs or a readme.
Edit: Not sarcasm. I value my time.