Documentation for the release

[David Miller]

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                                   http://www.justdave.net/
System Administrator, Mozilla Foundation       http://www.mozilla.org/
Project Leader, Bugzilla Bug Tracking System  http://www.bugzilla.org/