On 11/21/2016 11:58 AM, James Knott wrote:
On 11/21/2016 11:29 AM, Patrick Shanahan wrote:
And YOU have submitted a change-request for improved documentation?
Back when I was creating documentation, at IBM, there was no such thing. I was expected to have it right before releasing it.
IBM is IBM. They can and do pay to have .. Well, in my time with startups and buying s/w from start-ups I've often recommended that they sit down and try out every example in the docco to see if it does what the docc says it does, if the screens look like the illustrations in the doco. The thing is this takes time and manpower and it costs and all to many startups are more concern3ed with 'first to market' and something like this might slow things down or impede the release of the latest-and-greatest. But IBM cares about quality and doesn't get its underwear in a twist over being first to market. Having a superior product is what matters. And part of being superior is having superior docco. FOSS is more retrograde than startups when it comes to these matters. The docco is often written by the programmers and is worded in terms that are relevant to the programmer rather an a non-programming end user, and are often about things that matter to the programmer rather than an end user. The docco is debugged, if it is, by the same 'many eyes' attitude that is supposed to apply to quality and security of the code. Often the docco is only a MAN page and we all know about the efficacy of MAN pages as end user docco. Citing IBM just highlights the contrast with their methods, hiring, training, sales, quality control, customer support as well as documentation with FOSS. And revenue to pay for all that. -- A: Yes. > Q: Are you sure? >> A: Because it reverses the logical flow of conversation. >>> Q: Why is top posting frowned upon? -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org