Installation usability testing

[Frédéric Buclin]

Le 06. 04. 09 11:50, Gervase Markham a écrit :
> The skills necessary to improve
> documentation are more widely spread, and exist in a far larger
> proportion of the Bugzilla user base, than for the code

We still need to review it. If you write it wrong, the doc won't 
compile, Tinderbox will turn red, and as soon as we release a new 
version of Bugzilla, we cannot revert the doc (in that version). Wiki is 
not tied to a single release (which has advantages and disavantages, 
because you may talk about something which is not available in your 
specific version) and can be updated at any time. So as long as 
something is checked in into CVS, being docs or code, it must be 
reviewed. Colin and others are pretty fast to do such reviews anyway.


> Reading the install documentation, it hasn't changed much since I last
> overhauled it several years ago. There are several bits which are just
> plain wrong, and have been for years.

So feel free to file a bug and attach a patch. :) We all agree that some 
imperfect doc is better than no doc at all, and we rarely deny review 
based on this criteria (unless it's plain wrong or too complex to read). 
When we deny review, it's rather because the doc won't compile or the 
doc is written at the wrong location.

LpSolit