← Back to context

Comment by lhorie

4 years ago

I've noticed that some projects being complimented for having good docs come from CTOs (esbuild is another example). I'm hoping that by pointing out this little correlation, people might feel more inclined to spend more time on writing docs for their projects if they aspire to climb in the career ladder :)

12 comments

lhorie

Reply
jbverschoor  4 years ago

PostgreSQL, FreeBSD, Debian, rails all have superb docs.

Also, the software quality is high. This used to be the case for Apple and windows sdks. Not anymore.. now it’s “read the code“ or stack overflow

vijaybritto  4 years ago

Thats a very good point. In my company whoever writes the most valuable and extensive docs are looked up by people automatically. Either for clarifications or just networking. For the past couple of months I have been making devtools for QA and documenting them and just recently found out that every single team uses them and got recognized for it in the all hands!!

  • peakaboo  4 years ago

    Any extra salary? No of course not. Lol.

    • lhorie  4 years ago

      Anecdata, but after I released Mithril.js, I started getting contacted by recruiters from Bay Area companies. I now make 4 times as much as I did when I first started working on it. I know of other folks that got poached by high tech companies due to growing prominence in open source.

      FWIW, my experience reflects GP that people really appreciate someone who takes the time to teach/help others. YMMV.

      4 replies →