[ZDP] local Zope Documentation

Jimmie Houchin jhouchin@texoma.net
Sat, 18 Mar 2000 10:31:55 -0600


Hello,

I have looked at and downloaded your PDF compilation. I had some
problems with it that I can't remember at the moment. Unfortunately I
had to download it to my wife's Mac at home because it is the computer
of mine with a printer. I have a big problem printing PDFs on that Mac.
Printing 20 pages of a PDF can create a 200-400mb spool file from a
100+k document. Yuck! This is with Acrobat 4, Acrobat 3 does not have
this problem. But Acrobat 3 doesn't do odd and even pages. :(  Since I
moved everything to a 10gb drive I have less problems.

One issue I have with the compilation is that it is difficult to print
what you want selectively. It would be nice if it were organized
topically rather than by date or title which are generally irrelevant
since it doesn't group them into any logical structure.

How about grouping by:
DTML
SQL
ZClasses
etc.

It would be nice if we could adopt some documentation conventions which
would automatically enable categorization of documents. A nice little
metadata flag category='SQL' or some such. Of course I may have not
caught up on my reading yet and it's already available. If so my
apologies.

I am not putting down your compilation. I thoroughly appreciate the work
you did putting it together. But when I went to print it, I had no way
to logically select groupings of pages for a subject.

In addition to grouping your 'all' how-tos topically, how about offering
smaller groupings topically? So that if some needs to improve their DTML
zen they can download the 'all-dtml-how-tos.pdf' and print. :)

Just some thoughts.



Alexandre Ratti wrote:
> 
> Hello,
> 
> At 12:00 17/03/2000 -0800, you wrote:
> >Date: Fri, 17 Mar 2000 12:57:28 -0600
> >From: Jimmie Houchin <jhouchin@texoma.net>
> >To: George Runyan <grunyan@emerging.com>
> >Subject: Re: [ZDP] local Zope Documentation
> 
> >I too like local documentation. I think it would be wonderful if I could
> >have all Zope docs in a local Zope installation.
> 
> Note you can download a PDF compilation of Zope Howtos and Tips from my doc
> page: <http://www.zope.org/Members/AlexR/ZopeDocs>.
> 
> The PDFs are not structured, though. They are just a compilation from a
> flat list for easier browsing and printing.
> 
> I agree we need to create a keyword/topic indexing system (see postings
> from David earlier this week) for ZDP resources and gradually extend it to
> all Zope resources.
> 
> Cheers.
> 
> Alexandre
> 
> _______________________________________________
> ZDP maillist  -  ZDP@zope.org
> http://lists.zope.org/mailman/listinfo/zdp