Troy Engel schrieb:
Luigi Rosa wrote:
Timo Sirainen said the following on 1/3/2007 14:03:
And what should the wiki exported to doc/ directory in the tarball look like?
I think that the tarball should contain a "link" to wiki documentation.
I might suggest handling it like Exim does -- the main dovecot.tar.gz is the code only, and there's a second download of dovecot-docs.tar.gz; this way you can release updated/fixed documentation (and indeed maintain it separately) from the running codeball.
Maintaining it separately is what already happens, but separate downloads confuse end users even if they are skilled admins, because it makes the whole dovecot story inconcise and inconvenient.
A tarball should be self-contained, code and docs that don't require X11 stuff, period.
Plus, documentation must match code, which isn't necessarily the case for separate doc tarballs (special formats can be kept separate, but basic docs in a common/standard format should remain in the code tarball) - nobody stops Timo from releasing X.Y.1 with one line in the NEWS file "+ fixed several documentation inaccuracies" or thereabouts.