On 09/02/2015 03:52 PM, Carlos E. R. wrote:
info pages, on the other hand, can be organized with a table of contents, with descriptive chapters and usage samples. It is up to the writer.
Documentation writing is generally acknowledged as being the hardest ting a programmer has to do, and many are simply not suited for it. Big name Firms such as IBM and Microsoft have professional writers who grill the programmers, write it up and have the programmers verify its correctness. Sadly many of them don't always "debug" this by having a team of 'joe sixpack" inexperienced users try out the documentation and suggestions. I recall at one small development shop I was vilified for suggesting have a naive user try the examples in the documentation before it was shipped. All the worse, because I'd tried them myself as an experienced user and they didn't work! -- 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