You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs-dev@perl.apache.org by Stas Bekman <st...@stason.org> on 2002/03/22 15:12:18 UTC
to compress or not to?
I'm not sure whether it's a good idea to have the pdf and src gzipped,
it seems that most browsers cannot handle properly gzip attachement and
mess things up. On the other hand without gzip the size is bigger. So
does anybody think that we should keep things gzipped?
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: to compress or not to?
Posted by Stas Bekman <st...@stason.org>.
Per Einar Ellefsen wrote:
> At 01:00 23.03.2002 +0800, Stas Bekman wrote:
>
>> Per Einar Ellefsen wrote:
>>
>>> At 22:12 22.03.2002 +0800, Stas Bekman wrote:
>>>
>>>> I'm not sure whether it's a good idea to have the pdf and src
>>>> gzipped, it seems that most browsers cannot handle properly gzip
>>>> attachement and mess things up. On the other hand without gzip the
>>>> size is bigger. So does anybody think that we should keep things
>>>> gzipped?
>>>
>>>
>>> Ok, I know, I'm new here, but I'll give my point of view:
>>
>>
>> Thanks for chiming in, Per Einar :)
>
>
> I'd really like to help out, so please, if I can help with anything,
> please say so. I'm not that great with designing myself, but I have
> strong opinions on how things should look, and know enough about all the
> standards, etc etc...
Yes, we need the following help:
- we need to make sure that our site is complient with HTML/CSS w3c
standards. that means running sgml or similar checkers and fixing things
that are broken.
- we need help with the content. I've added a bunch of FIXME in the
content, and there are many places that don't have these. e.g. each
document needs a description so there will be a nice index page
including those descriptions. and of course we need to review the
existing content which is no under /docs and improve it. You don't
really want to go into /docs, because there are more than a thousand
printed pages there :) but all the rest (which is much much smaller
needs to be reviewed and improved).
If you and others are willing to give a hand, the best way to go is to
get the cvs rep checked out, fix things and send patches here to the
list or directly to me.
That will help a lot.
To get the cvs rep see:
http://cvs.apache.org/viewcvs.cgi/~checkout~/modperl-docs/README?rev=1.6&content-type=text/plain
Thanks!
>>> Personally, I think the PDF version shouldn't be gzipped, as it
>>> clearly creates problems: the point of a PDF version is to have
>>> something that looks great, has all the information in one file, is
>>> nicely printable, but is also viewable from a web browser. People
>>> don't care whether it takes a minute or two more to download it
>>> (depending on the connection of course.. it might be a second or
>>> two), but they do care if they find out they can't open it once they
>>> have downloaded it.
>>
>>
>> that's what I was thinking :) As I was annoyed myself for not being
>> able to open it right away with mozilla.
>>
>>> As for the src, that's not as important, as most people won't be
>>> downloading that anyway. I think that one should remain gzipped.
>>
>>
>> But then to be consistent shouldn't we have this uncompressed to?
>> The source files are much smaller than pdfs, e.g.:
>>
>> dst_html/docs/1.0/guide/strategy.pdf 71509
>> dst_html/docs/1.0/guide/strategy.pod 48392
>>
>> compressed:
>> dst_html/docs/1.0/guide/strategy.pdf.gz 55516
>> dst_html/docs/1.0/guide/strategy.pod.gz 17627
>>
>> pdf is already quite compressed.
>>
>> On the other hand I doubt people will download source at all,
>> other than sending patches :)
>
>
> Oh yes, if it's just a pod file, then ok. I hadn't really looked at it,
> but if it's not gzipped, it's actually better, because then those who
> know pod can just look at the source quiclly by hitting the link.
OK, so unless there are other strong opinion I'll remove the gzipping part
and keep the download docs as is.
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: to compress or not to?
Posted by Per Einar Ellefsen <pe...@skynet.be>.
At 01:00 23.03.2002 +0800, Stas Bekman wrote:
>Per Einar Ellefsen wrote:
>>At 22:12 22.03.2002 +0800, Stas Bekman wrote:
>>
>>>I'm not sure whether it's a good idea to have the pdf and src gzipped,
>>>it seems that most browsers cannot handle properly gzip attachement and
>>>mess things up. On the other hand without gzip the size is bigger. So
>>>does anybody think that we should keep things gzipped?
>>
>>Ok, I know, I'm new here, but I'll give my point of view:
>
>Thanks for chiming in, Per Einar :)
I'd really like to help out, so please, if I can help with anything, please
say so. I'm not that great with designing myself, but I have strong
opinions on how things should look, and know enough about all the
standards, etc etc...
>>Personally, I think the PDF version shouldn't be gzipped, as it clearly
>>creates problems: the point of a PDF version is to have something that
>>looks great, has all the information in one file, is nicely printable,
>>but is also viewable from a web browser. People don't care whether it
>>takes a minute or two more to download it (depending on the connection of
>>course.. it might be a second or two), but they do care if they find out
>>they can't open it once they have downloaded it.
>
>that's what I was thinking :) As I was annoyed myself for not being able
>to open it right away with mozilla.
>
>>As for the src, that's not as important, as most people won't be
>>downloading that anyway. I think that one should remain gzipped.
>
>But then to be consistent shouldn't we have this uncompressed to?
>The source files are much smaller than pdfs, e.g.:
>
>dst_html/docs/1.0/guide/strategy.pdf 71509
>dst_html/docs/1.0/guide/strategy.pod 48392
>
>compressed:
>dst_html/docs/1.0/guide/strategy.pdf.gz 55516
>dst_html/docs/1.0/guide/strategy.pod.gz 17627
>
>pdf is already quite compressed.
>
>On the other hand I doubt people will download source at all,
>other than sending patches :)
Oh yes, if it's just a pod file, then ok. I hadn't really looked at it, but
if it's not gzipped, it's actually better, because then those who know pod
can just look at the source quiclly by hitting the link.
--
Per Einar Ellefsen
per.einar@skynet.be
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: to compress or not to?
Posted by Stas Bekman <st...@stason.org>.
Per Einar Ellefsen wrote:
> At 22:12 22.03.2002 +0800, Stas Bekman wrote:
>
>> I'm not sure whether it's a good idea to have the pdf and src gzipped,
>> it seems that most browsers cannot handle properly gzip attachement
>> and mess things up. On the other hand without gzip the size is bigger.
>> So does anybody think that we should keep things gzipped?
>
>
> Ok, I know, I'm new here, but I'll give my point of view:
Thanks for chiming in, Per Einar :)
> Personally, I think the PDF version shouldn't be gzipped, as it clearly
> creates problems: the point of a PDF version is to have something that
> looks great, has all the information in one file, is nicely printable,
> but is also viewable from a web browser. People don't care whether it
> takes a minute or two more to download it (depending on the connection
> of course.. it might be a second or two), but they do care if they find
> out they can't open it once they have downloaded it.
that's what I was thinking :) As I was annoyed myself for not being able
to open it right away with mozilla.
> As for the src, that's not as important, as most people won't be
> downloading that anyway. I think that one should remain gzipped.
But then to be consistent shouldn't we have this uncompressed to?
The source files are much smaller than pdfs, e.g.:
dst_html/docs/1.0/guide/strategy.pdf 71509
dst_html/docs/1.0/guide/strategy.pod 48392
compressed:
dst_html/docs/1.0/guide/strategy.pdf.gz 55516
dst_html/docs/1.0/guide/strategy.pod.gz 17627
pdf is already quite compressed.
On the other hand I doubt people will download source at all,
other than sending patches :)
__________________________________________________________________
Stas Bekman JAm_pH ------> Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org
Re: to compress or not to?
Posted by Per Einar Ellefsen <pe...@skynet.be>.
At 22:12 22.03.2002 +0800, Stas Bekman wrote:
>I'm not sure whether it's a good idea to have the pdf and src gzipped, it
>seems that most browsers cannot handle properly gzip attachement and mess
>things up. On the other hand without gzip the size is bigger. So does
>anybody think that we should keep things gzipped?
Ok, I know, I'm new here, but I'll give my point of view:
Personally, I think the PDF version shouldn't be gzipped, as it clearly
creates problems: the point of a PDF version is to have something that
looks great, has all the information in one file, is nicely printable, but
is also viewable from a web browser. People don't care whether it takes a
minute or two more to download it (depending on the connection of course..
it might be a second or two), but they do care if they find out they can't
open it once they have downloaded it.
As for the src, that's not as important, as most people won't be
downloading that anyway. I think that one should remain gzipped.
--
Per Einar Ellefsen
per.einar@skynet.be
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-dev-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-dev-help@perl.apache.org