Documentation for the release

David Miller justdave at
Sun Jan 16 23:33:24 UTC 2005

Gervase Markham wrote:
> byron wrote:
>> i'd agree with that if the docs weren't bundled with the product.  if i
>> download a tarball that includes a manual, i'd expect it to be up to 
>> date, with updates only occuring with a new versioned release of the 
>> product.  i
>> also don't think it's unreasonable to expect that the online docs for 
>> 2.18.0
>> always match the docs in the 2.18.0 tarball.
> I certainly agree that the docs should not undergo major reorganisation 
> post-release, for the reason you gave. The 2.18.7 docs should be 
> substantially similar to the 2.18.0 docs, such that anyone familiar with 
> the latter can easily find what they want in the former.

If the docs were actually complete when we shipped, I would tend to 
agree.  But since they aren't, we continue to improve them until they 
are, or the branch gets EOLed, whichever happens first.  At the rate 
we're going, I suspect 2.20 will probably ship with reasonably complete 
documentation.  Neither 2.16 nor 2.18 did (although 2.18's is certainly 
more complete than the original docs that shipped with 2.16).

Dave Miller                         
System Administrator, Mozilla Foundation
Project Leader, Bugzilla Bug Tracking System

More information about the developers mailing list