httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "kajaa" <ka...@eastday.com>
Subject Re: don't distribute docs with source?
Date Wed, 04 Jun 2003 02:37:41 GMT
I don't think it's necessary.

For a detailed considering,

now, the download package is in a size of nearly 6M bytes, in the future,
the package size increasing may be mainly caused by including more different
language docs, not the executable files.

And, as I tested, for each new completely translated language docs, the
package size will increase a little more than 1M bytes, the rate is
sustainable, at least I think so.

But, the danger is not that low as you English speaker experts expected. You
can suppose that, a non-Engish speaker user, after downloading, open help,
oh, it's a English only one, immediately, uninstall and try another, or give
up, choose IIS.

As a chinese speaker, I know, more than 1/5 questions for Apache are "where
to find a Chinese manual?", and the other questions maybe easily answered if
they carefully read the manual. So I think, localization is really important
for a software which is expected to be used everywhere in the world.

kajaa

----- Original Message ----- 
From: "Joshua Slive" <joshua@slive.ca>
To: <docs@httpd.apache.org>
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


Mime
View raw message