News for hackers. Stuff that matters.
Re:Free software is suffering because coders don’t know how ... by epc on Friday June 02, 2017 @02:24PM (#14472211)
Technical writing is dead as a profession.

Too many companies expect technical writers to be as savvy, or more, as their developers, but for lower pay, less respect, and zero political power.

This attitude bleeds through to open source/free software.

You want better documentation? Find a way to compensate people for contributing to it, and that doesn't necessarily mean money. Separate your documentation repository from your code base.

Re:Free software is suffering because coders don’t know how ... by hkmurakami on Friday June 02, 2017 @02:32PM (#14472282)
Afaik RedHat pays their documentation engineers and QA engineers very well, since they consider those roles to be essential to the product from the customer's expectations. It's a perspective rarely shared by other companies though.
Re:Free software is suffering because coders don’t know how ... by praneshp on Friday June 02, 2017 @04:14PM (#14472955)
> "It's a perspective rarely shared by other companies though."

This is not the worst case scenario. Some places will sensationally hire QA/Writers, hailing their importance, and lay them off at the first sign of cost cutting.

Re:Free software is suffering because coders don’t know how ... by epc on Friday June 02, 2017 @06:02PM (#14473633)
I lost one other recommendation there…you want better documentation? Do not reject documentation which accurately documents problems in your OSS project/product. Rejecting pull requests because they (accurately) document a solution to a problem posed by your product will only guarantee the writer will never submit another documentation pull request.

Not that that's happened to me.

Re:Free software is suffering because coders don’t know how ... by biocomputation on Friday June 02, 2017 @07:22PM (#14473956)
<< Technical writing is dead as a profession.

Hmm, I couldn't disagree more!

<< Too many companies expect technical writers to be as savvy, or more, as their developers, but for lower pay, less respect, and zero political power.

Hmm, I couldn't agree more!