3 ms·

> Sharing takes extra effort. its more than a little extra effort though. If some library you use yourself takes X effort, cleaning API, making good documentat

• weaksauce 10y ago
  What work is worth it to do with 100% certainty? A lot of times these things open up new opportunities even though you might find yourself working on a bust. most times even if it's not valuable from the get go you can always use it when someone asks about your open source contributions or maybe the thing you are working on sparks an idea for another product or gives you some working knowledge of some new library or language that is useful for your next job search.
• TeMPOraL 10y ago
  But doing that 8x work is a difference between an obscure Github repo and next fad in the JS world. (You could probably skip making good documentation, everybody does that and it doesn't seem to stop popularity.) I'd also question making good documentation is 3x the effort - not if your product is really doing anything interesting. For interesting stuff, most work is in the internals and not at the edges that will be documented.
  • rhizome 10y ago
    Documentation is not about functionality, but about maintenance and the Bus Factor.