News for hackers. Stuff that matters.
Re:WTFM - Write The Freaking Manual by dredmorbius on Friday September 28, 2012 @03:14PM (#4587277)
1. Figure out a way to get paid for it.

2. If you're designing tools for other people to use, documentation really, really, really matters. Even if it's just a mailing list and wiki initially.

When I'm evaluating tools, I look to the docs, and if I find them lacking, my interest dims very, very rapidly. I'm a systems admin, and don't do much coding (though programmers have a need for docs as well). My main concerns are uptime, reliability, predictability, and well-understood behavior. If a tool shows a wild cowboy shoot-from-the-hip, damn the torpedoes mentality, it's going to make my life (and my sleep quantity and quality) hell.

Life's too short for that shit.

There are no comments on this comment yet.