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:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
