I thought this might be relevant to us. It would be great if each of the module's docs had a link in the introduction to the module's JIRA for readers to submit documentation-related issues. -------- Original Message -------- Subject: Re: On sucking less Date: Thu, 04 Nov 2010 12:05:18 +1000 From: Darrin Mison <dmison(a)redhat.com&gt; To: Robb Greathouse <robb.greathouse(a)jboss.com&gt; CC: The Core <thecore(a)redhat.com&gt; On Wed, 2010-11-03 at 16:31 -0400, Robb Greathouse wrote: Log a bug against the document :-) If it is a product document (JBoss Enterprise Widget Platform) then there should be a feedback section right at the beginning with the info about where/how to log docs bugs. It's not very discoverable IMHO but it is there. If it is a community document then your milage may vary but each project generally has a docs component in JIRA. In that particular example it's probably better to have the example title summarize the purpose of the example, rather than a file name. The accompanying procedure that the example is illustrating should define what file/s etc it applies to. --- Darrin Mison Red Hat JBoss Middleware Documentation