From docs-return-5283-apmail-httpd-docs-archive=httpd.apache.org@httpd.apache.org Wed Jun 04 03:00:07 2003 Return-Path: Delivered-To: apmail-httpd-docs-archive@httpd.apache.org Received: (qmail 61290 invoked by uid 500); 4 Jun 2003 03:00:06 -0000 Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Reply-To: docs@httpd.apache.org Delivered-To: mailing list docs@httpd.apache.org Received: (qmail 61275 invoked from network); 4 Jun 2003 03:00:05 -0000 Message-ID: <000801c32a45$663400e0$195b90d3@pzhang> From: "kajaa" To: References: Subject: Re: don't distribute docs with source? Date: Wed, 4 Jun 2003 11:00:03 +0800 MIME-Version: 1.0 Content-Type: text/plain; charset="Windows-1252" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 6.00.2800.1158 X-MIMEOLE: Produced By Microsoft MimeOLE V6.00.2800.1165 X-OriginalArrivalTime: 04 Jun 2003 03:00:05.0230 (UTC) FILETIME=[663400E0:01C32A45] X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N And, I think, it maybe better to give many separated download packs, each with one language docs. kajaa ----- Original Message ----- From: "Joshua Slive" To: Sent: Wednesday, June 04, 2003 4:18 AM Subject: don't distribute docs with source? > Have we gotten to a point where the docs distribution should be > distributed separately from the source distribution? > > Advantages: > - Less bandwidth used for cvs checkouts and downloads since people get > only what they want. > - People can choose the particular format that they want: > * pure xml > * multi-language html to be viewed through the server > * single-language html that can be viewed using just a browser > * chm > * pdf (?) > - Don't need to keep generated files in cvs, since docs experts can > generate docs releases. (There is still a question about what to do for > the web checkout, since generating files directly onto the live website is > probably not a good idea.) > > Disadvantages: > - May generate more bandwidth usage on httpd.apache.org/docs-2.0/ > because people will be too lazy to download the docs. > - May encourage coders to ignore the docs. > - May be more complicated for end users. > > I don't have a very strong opinion on this, but we should probably think > about it, since it would solve several of the problems we have been > discussing. Of course, any final decision would need to be discussed with > dev@httpd as well. > > Joshua. > > --------------------------------------------------------------------- > To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org > For additional commands, e-mail: docs-help@httpd.apache.org > --------------------------------------------------------------------- To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org For additional commands, e-mail: docs-help@httpd.apache.org