4 ms·
Sad to read your n=20 was like that. There are also cases where documentation led companies to growth—one example is Stripe. Poking the finger at documentation
by remoquete 2y ago
Sad to read your n=20 was like that. There are also cases where documentation led companies to growth—one example is Stripe.
Poking the finger at documentation is easy because it's visible and readily available. Would you say the bit rot phenomenon you described never happened to code, or processes, or UIs? Docs reflect organizations.
- apwell23 2y ago> There are also cases where documentation led companies to growth—one example is Stripe. how do you know this ?
- remoquete 2y agoIt's known. Example: https://mintlify.com/blog/stripe-docs https://mintlify.com/blog/stripe-docs
- apwell23 2y ago> developer tool documentation i dont think thats what is being talked about here. Why would they write shitty tool documentation if practically their product. OP is talking about this > never once did I see code documentation work out well. They are not synonymous. My company's external api has amazing documentation but we have shitty internal code documentation.
- remoquete 2y agoMy post wasn't concerned with internal code documentation. Seems like we're having parallel conversations.
- deleted 2y ago[deleted]
- apwell23 2y agogotcha. > There are also cases where documentation led companies to growth—one example is Stripe. when you said 'there are also' i thought you were talking about the same thing as the comment you were responding to. Not sure how existence of something totally unrelated to original comment is relevant.
- misja111 2y agoI wasn't talking about external api's or libraries, I actually mentioned that >> With the exception of external libraries or API's, .. Those I agree are different, the documentation is part of the product that you offer or sell to external customers.