Re: How to patch the docs

2016-07-18 Thread Rich Bowen
On 07/18/2016 06:08 AM, Mads Toftum wrote: > On Fri, Jul 15, 2016 at 03:11:20PM -0400, Rich Bowen wrote: >> I periodically give a presentation on documentation - how to make your >> docs not suck, how to work with users to solve their problems, how to >> make it easier for people to contribute

Re: How to patch the docs

2016-07-18 Thread Mads Toftum
On Fri, Jul 15, 2016 at 03:11:20PM -0400, Rich Bowen wrote: > I periodically give a presentation on documentation - how to make your > docs not suck, how to work with users to solve their problems, how to > make it easier for people to contribute to the docs. > Is this something that can be found

Re: How to patch the docs

2016-07-18 Thread Astrid Malo
Am Mon, 18 Jul 2016 09:18:32 +0200 schrieb Lucien Gentis : > Hello docs people, > > Some remarks : > > "Comments" link on each page doesn't indicate clearly enough that its > purpose is adding comments about the doc itself, instead of being a > Q I think that's

Re: How to patch the docs

2016-07-18 Thread Lucien Gentis
Hello docs people, Some remarks : "Comments" link on each page doesn't indicate clearly enough that its purpose is adding comments about the doc itself, instead of being a Q I think that's the reason why there are thousands of comments. How about replacing it by something like "Report an

Re: How to patch the docs

2016-07-15 Thread Luis Gil de Bernabé
El 15 jul. 2016 21:11, "Rich Bowen" escribió: > > I periodically give a presentation on documentation - how to make your > docs not suck, how to work with users to solve their problems, how to > make it easier for people to contribute to the docs. > > I often give advice that

How to patch the docs

2016-07-15 Thread Rich Bowen
I periodically give a presentation on documentation - how to make your docs not suck, how to work with users to solve their problems, how to make it easier for people to contribute to the docs. I often give advice that we are not following in this docs project. Some of these are historical (I