From dougdaniel@webwizint.com Sat Apr 1 15:31:26 2000 From: dougdaniel@webwizint.com (Doug Daniel) Date: Sat, 1 Apr 2000 07:31:26 -0800 Subject: [ZDP] RAD Message-ID: <00ac01bf9bef$5a9e0e20$d1610118@lvrmr1.sfba.home.com> This is a multi-part message in MIME format. ------=_NextPart_000_00A9_01BF9BAC.4A0B7BD0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Is there any equivalent to ColdFusion or eGrail for Zope? any Rapid = Application Development tools? Doug Daniel www.webwizint.com 925.606.1310 - Voice 925.606.0381 - FAX 925.518.4378 - Mobile ------=_NextPart_000_00A9_01BF9BAC.4A0B7BD0 Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable
Is there any equivalent to ColdFusion = or eGrail for=20 Zope? any Rapid Application Development tools?
 
Doug Daniel
www.webwizint.com
925.606.1310 = -=20 Voice
925.606.0381 - FAX
925.518.4378 - = Mobile
------=_NextPart_000_00A9_01BF9BAC.4A0B7BD0-- From Tom Deprez" Message-ID: <000c01bf9bf3$e0b85c00$0101a8c0@paladin> This is a multi-part message in MIME format. ------=_NextPart_000_0009_01BF9C04.A27D8300 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Hi Doug, No, There isn't one. I believe this is mainly because of the fact that = Zope is multi-platform. Besides, Zope uses the browser as tool to create = it's environment. This means that you can change your Zope website from = whatever place you want and you only need a browser to do it! Tom. ----- Original Message -----=20 From: Doug Daniel=20 To: zdp@zope.org=20 Sent: Saturday, April 01, 2000 5:31 PM Subject: [ZDP] RAD Is there any equivalent to ColdFusion or eGrail for Zope? any Rapid = Application Development tools? Doug Daniel www.webwizint.com 925.606.1310 - Voice 925.606.0381 - FAX 925.518.4378 - Mobile ------=_NextPart_000_0009_01BF9C04.A27D8300 Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable
Hi Doug,
 
No, There isn't one. I believe this is = mainly=20 because of the fact that Zope is multi-platform. Besides, Zope uses the = browser=20 as tool to create it's environment. This means that you can change your = Zope=20 website from whatever place you want and you only need a browser to do=20 it!
 
Tom.
----- Original Message -----
From:=20 Doug=20 Daniel
To: zdp@zope.org
Sent: Saturday, April 01, 2000 = 5:31=20 PM
Subject: [ZDP] RAD

Is there any equivalent to ColdFusion = or eGrail=20 for Zope? any Rapid Application Development tools?
 
Doug Daniel
www.webwizint.com
925.606.1310 = -=20 Voice
925.606.0381 - FAX
925.518.4378 -=20 Mobile
------=_NextPart_000_0009_01BF9C04.A27D8300-- From evan@digicool.com Sat Apr 1 16:48:57 2000 From: evan@digicool.com (Evan Simpson) Date: Sat, 1 Apr 2000 11:48:57 -0500 Subject: [ZDP] RAD References: <00ac01bf9bef$5a9e0e20$d1610118@lvrmr1.sfba.home.com> <000c01bf9bf3$e0b85c00$0101a8c0@paladin> Message-ID: <003e01bf9bfa$2d19fb70$8400a8c0@mozart> > From: Tom Deprez > No, There isn't one. I believe this is mainly because of the fact that Zope is multi-platform. Besides, Zope uses the > browser as tool to create it's environment. This means that you can change your Zope website from whatever place you > want and you only need a browser to do it! On the other hand, there is an effort under way to create a smarter cross-platform client (I don't know if you would call it an IDE) based on Mozilla. It's more a proof-of-concept than a usable tool right now, but its future is bright. Cheers, Evan @ 4-am & digicool From roeder@berg.net Sat Apr 1 17:53:13 2000 From: roeder@berg.net (Maik Roeder) Date: Sat, 01 Apr 2000 19:53:13 +0200 Subject: [ZDP] Does the ZDP need it's own Mailing List archive for quoting messages ? ? Message-ID: <38E63789.D135CB5E@berg.net> Hi ! I have taken some time to write this proposal for a mailing list tracker which we could use for the ZDP project. I would like to hear from you whether we really need such a program, and if so what you think it should be like. -------------------------- Does the ZDP need it's own Mailing List archive for quoting messages ? It would be nice to have a Mailing list tracker on the ZDP site, where all messages, which are sent to all of the Zope mailing lists are kept. The messages could then be used for searching on specific topics, and could also be directly reused when new pieces of documentation are written. Reusing pieces of documentation right now means to track the mailing lists, using your own mail reader, or going to one of the online Mailing list trackers like egroups, and then cutting and pasting the message into your documentation. Just taking over content is not nice without giving credit to the original author. It is also not very user-friendly because much of the discussion, which has been surrounding the posting in the original discussion thread is simply lost. The original thread can be very useful for ZDP visitors, who may want to have a look at it when they see it quoted. Right now, giving a pointer to the original post is hard, because you can not be sure whether the site you are pointing to always keeps the URL, or for what is worse, even disappears. We need to be sure that a quoted message along with it's thread still exists in the future. We don't have enough space on the ZDP site to keep the whole Zope mailing lists, and so we are planning to digest the incoming mails only for a certain period of time. Afterwards, the mails will be deleted if they haven't appeared in a thread that has been quoted. We don't have the ressources to update the Mailing List Tracker everytime a mail is sent to a mailing list. So, to quote a mail, we need to manually upload all mails which have been written to that list since the last update. We also need to update threads to which new mails have been posted in the meantime. We also lack a tool for uploading messages to the Zope site. We could extend the Mailbag product by Tres Seaver which uses the Python 'rfc822' and 'mailbox' modules to parse messages and mailboxes. Lately, Tres Seaver has rewritten Mailbag, refactoring the logic into Python classes. The corresponding ZClasses for the presentation layer still have to be rewritten, but can possibly be taken over from the previous Mailbag version. To get the mail into Zope, a program needs to be written that calls Mailbag via ZClient when a mail arrives. Another type of program could be useful for importing existing Mailboxes into Zope. For delivery, an MDA like procmail could spawn a program out of a .forward file and ask it to upload the mail to a Zope folder according to a predefined set of recipies. There exists a Python program called getmail which takes mail from a POP3 server and delivers it into a mailbox. The delivery part of this program uses a getmailrc which could be used instead of the procmail recipies. Once the mail is in a local installation on a ZDP members own Zope server, it is easy to export the email and upload it to the ZDP site. From there, the ZDP members can quote the message easily by directly pointing to the URL. This way, we may not get a complete mail archive, but at least we can always be sure that the quoted mails and their surrounding thread exist. ---------------------- Greetings, Maik Röder -- Open Source is "about being able to work together with people you've never met, on projects that are in a constant state of flux, on a time schedule that would cause a hummingbird's head to spin." Paul Ferris, http://www.linuxplanet.com/linuxplanet/opinions/1593/1/ From woodsage@op.net Sun Apr 2 19:48:40 2000 From: woodsage@op.net (Eron Lloyd) Date: Sun, 02 Apr 2000 14:48:40 -0400 Subject: [ZDP] Learning (and teaching) DTML...by writing a manual on it Message-ID: <38E79607.F61EFCB8@op.net> Hello guys, I've been doing some thinking, and I want to seriously pursue this...a book on web programming with DTML. Not in the sense of a "dead tree" book, but an open manual for learning (mastering?) DTML. I want to start from scratch, meaning "Hey, I know HTML but little else...Zope looks great, what do I need to know to do useful things? I don't want to learn python yet, but I want to fully understand DTML. Where do I start?" I want that answer to be HERE: Mastering DTML: The Eight-Fold Way. Using the "Zen" of Zope, I'd like to write a working manual that would start the new Zope developer on his/her enlightened path, ranging from "what the heck is DTML?" to "How do I use DTML & XML to make my web app awesome?". I'll be using traditional bhuddism style of writing and try to create useful proverbs out of the underlying "Zope Zen", building on skills with each chapter. There should be oodles of code examples/tutorials, good reference structure, and a light writing style that both doesn't intimidate the newcomer or bore the experienced. What does everyone think? If it sounds like a good idea, my next question is "what would be the best way to teach DTML? What things should EVERYONE who will use it know, assuming they do not know any programming, etc.?" Since I am still considered a newbie myself, I think that a lot of questions I've had along the way are still fresh in my memory; however, what would be the best way to present this information? I know stuff like syntax style, creating variables, explanation of the different tags (and lots of example usage), etc. should come first, but then what? How about creating images, processing forms, generating tables, etc. and other useful skills? Any feedback would be greatly appreciated. Eron From moeller@networksplus.net Mon Apr 3 01:37:05 2000 From: moeller@networksplus.net (Derek Moeller) Date: Sun, 2 Apr 2000 19:37:05 -0500 Subject: [ZDP] ZDP web site Message-ID: <20000402193705.A3491@networksplus.net> Hello. The ZDP site is quite helpful. For some reason, though, the monospace font and the normal serif font have been switched throughout the site. Normal text is monospace, then when there's an example configuration file snippet, it's in the Times Roman-esque font. Not a big deal, but it does a number on readibility. Thanks -- Derek Moeller From tom.deprez@uz.kuleuven.ac.be Mon Apr 3 09:26:09 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Mon, 03 Apr 2000 10:26:09 +0200 Subject: [ZDP] Does the ZDP need it's own Mailing List archive for quoting messages ? ? In-Reply-To: <38E63789.D135CB5E@berg.net> Message-ID: <3.0.6.32.20000403102609.0096b470@poirot> Maik, I'm not sure if this will improve ZDP. It looks like lot's of things have to be taken into account and thus I'm not sure if it will be frequently used. Tom. At 19:53 01/04/2000 +0200, you wrote: >Hi ! > > >I have taken some time to write this proposal for a mailing list tracker >which we could use for the ZDP project. I would like to hear from >you whether we really need such a program, and if so what you think >it should be like. > >-------------------------- > >Does the ZDP need it's own Mailing List archive for quoting messages ? > > >It would be nice to have a Mailing list tracker on the ZDP site, where >all messages, which are sent to all of the Zope mailing lists are kept. >The messages could then be used for searching on specific topics, and >could also be directly reused when new pieces of documentation are written. > >Reusing pieces of documentation right now means to track the mailing lists, >using your own mail reader, or going to one of the online Mailing list >trackers like egroups, and then cutting and pasting the message into >your documentation. > >Just taking over content is not nice without giving credit to the original >author. It is also not very user-friendly because much of the discussion, >which has been surrounding the posting in the original discussion thread >is simply lost. The original thread can be very useful for ZDP visitors, >who may want to have a look at it when they see it quoted. > >Right now, giving a pointer to the original post is hard, because you can >not be sure whether the site you are pointing to always keeps the URL, or for >what is worse, even disappears. We need to be sure that a quoted message >along with it's thread still exists in the future. > >We don't have enough space on the ZDP site to keep the whole Zope mailing >lists, and so we are planning to digest the incoming mails only for a certain >period of time. Afterwards, the mails will be deleted if they haven't >appeared in a thread that has been quoted. > >We don't have the ressources to update the Mailing List Tracker everytime >a mail is sent to a mailing list. So, to quote a mail, we need to manually >upload all mails which have been written to that list since the last update. >We also need to update threads to which new mails have been posted in the >meantime. > >We also lack a tool for uploading messages to the Zope site. We could >extend the Mailbag product by Tres Seaver which uses the Python 'rfc822' >and 'mailbox' modules to parse messages and mailboxes. > >Lately, Tres Seaver has rewritten Mailbag, refactoring the logic into Python >classes. The corresponding ZClasses for the presentation layer still >have to be rewritten, but can possibly be taken over from the previous >Mailbag version. > >To get the mail into Zope, a program needs to be written that calls Mailbag >via ZClient when a mail arrives. Another type of program could be useful >for importing existing Mailboxes into Zope. > >For delivery, an MDA like procmail could spawn a program out of a .forward >file and ask it to upload the mail to a Zope folder according to a >predefined set of recipies. > >There exists a Python program called getmail which takes mail from a POP3 >server and delivers it into a mailbox. The delivery part of this program >uses a getmailrc which could be used instead of the procmail recipies. > >Once the mail is in a local installation on a ZDP members own Zope server, it >is easy to export the email and upload it to the ZDP site. From there, the >ZDP members can quote the message easily by directly pointing to the URL. > >This way, we may not get a complete mail archive, but at least we can always >be sure that the quoted mails and their surrounding thread exist. > >---------------------- > >Greetings, > >Maik Röder > >-- >Open Source is "about being able to work together with people you've >never met, on projects that are in a constant state of flux, on >a time schedule that would cause a hummingbird's head to spin." >Paul Ferris, http://www.linuxplanet.com/linuxplanet/opinions/1593/1/ > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From tom.deprez@uz.kuleuven.ac.be Mon Apr 3 09:43:10 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Mon, 03 Apr 2000 10:43:10 +0200 Subject: [ZDP] ZDP web site In-Reply-To: <20000402193705.A3491@networksplus.net> Message-ID: <3.0.6.32.20000403104310.00949e40@poirot> Hi Derek, I don't really follow : In ZDP all the fonts look the same in my browser Do you want that the normal text is in Times Roman-esque? We use the Verdana-font (made for web) Tom. At 19:37 02/04/2000 -0500, Derek Moeller wrote: > >Hello. The ZDP site is quite helpful. >For some reason, though, the monospace font and the normal serif font have been >switched throughout the site. Normal text is monospace, then when there's an >example configuration file snippet, it's in the Times Roman-esque font. > >Not a big deal, but it does a number on readibility. > >Thanks >-- >Derek Moeller > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From tom.deprez@uz.kuleuven.ac.be Mon Apr 3 09:46:14 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Mon, 03 Apr 2000 10:46:14 +0200 Subject: [ZDP] ZDP Message-ID: <3.0.6.32.20000403104614.00948cd0@poirot> Hi, I was looking around in ZDP and wondered what the new added class was used for :eg. ZTOPIC etc. Can somebody tell me this? Thanks, Tom. From woodsage@op.net Mon Apr 3 17:01:25 2000 From: woodsage@op.net (Eron Lloyd) Date: Mon, 03 Apr 2000 12:01:25 -0400 Subject: [ZDP] Learning DTML - an addition to ZBook Message-ID: <38E8C055.CCF9F536@op.net> Hey hey hey! Ok, I've decided to work on a thorough study of DTML, and add it to ZBook. I don't know how well it will flow at first, but that's the beauty of write, edit, rewrite, revise :-) Anybody that wants to look at what I wrote feel free to contact me. Currently, I've come up with somewhat of a structure: Learning DTML ---------------------- 1.) Common Questions [Q.] What is DTML? [A.] Zope's scripting/reporting language used to create/manipulate(process?)/display Web objects. [Q.] How do I use it? What do I use it for? [A.] DTML is a powerful but simple language you use to create dynamic Web applications in Zope. It can written in documents or embedded from a separate script (more explanation). It can be used to: - create/insert variable data - format date/time information - "if" statements (selective actions/conditional insertation) - "in" statements - batch processing - display objects - name/expression evaluation - expression handling - comment code - ...? [Q.] It's a programming language? I don't know how to progam! All I know is HTML. I don't have time to learn Python. Can I still learn DTML? What's the best way to approach it? [A.] ...? There should be good examples of each dtml tag in action, explanations, advanced usage, case studies, and exercises for users to step through. 2.) Using DTML for real world tasks [Q.] How do I... - create/use variables? - add the date/time to my site? - create a feedback form? - search through Web objects - ..? I hate to admit it, but we need to take a "DTML for Dummies" approach if we want to be able to do this effectively. Although I've volunteered to spearhead this effort, I feel even I know very little about the language (although this will also help me to start out very, very basic). There are many questions/answers that need to be formulated, and I would like to encourage a general discussion of the aspects of learning and using DTML. I will collect all responses, and start to mold some structure out of them. All newbies are heartily encouraged to ask ANY questions about things they don't know or problems they've had, and all Zope guru's please give us some gems of wisdom. I want this to be an exhuastive "study" of DTML, not an argument on what's wrong with the language, or what's wrong with the current documentation, etc. Positive feedback only, thank you. Tom: I have a beginning draft; what should I do to add it to the ZDP site? Thanks in advance to all that choose to participate in helping this DTML manual. Eron Lloyd From kayeva@hotmail.com Mon Apr 3 19:47:33 2000 From: kayeva@hotmail.com (kamon ayeva) Date: Mon, 03 Apr 2000 18:47:33 GMT Subject: [ZDP] Learning DTML - an addition to ZBook Message-ID: <20000403184733.85874.qmail@hotmail.com> >From: Eron Lloyd >Hey hey hey! Ok, I've decided to work on a thorough study of DTML, and >add it to ZBook. I don't know how well it will flow at first, but that's >the beauty of write, edit, rewrite, revise :-) Anybody that wants to >look at what I wrote feel free to contact me. Currently, I've come up >with somewhat of a structure: Good, there's work to do. You might want to check ZCL first and what Dody has written so far. I am not sure he is still active on the list, so it's a good opportunity for you to continue his work. Cheers, Kamon kayeva@hotmail.com ______________________________________________________ Get Your Private, Free Email at http://www.hotmail.com From kankie@thegrid.net Mon Apr 3 20:22:05 2000 From: kankie@thegrid.net (David Kankiewicz) Date: Mon, 03 Apr 2000 12:22:05 -0700 Subject: [ZDP] ZDP References: <3.0.6.32.20000403104614.00948cd0@poirot> Message-ID: <38E8EF5D.C7A2BCE0@thegrid.net> Tom Deprez wrote: > > Hi, > > I was looking around in ZDP and wondered what the new added class was used > for :eg. ZTOPIC etc. Can somebody tell me this? > > Thanks, > > Tom. > Hi Tom, zTopic and zSubject are for a Hierarchy hidden in the /zope dir, I'm short on time so it'll be a few days before I'm able to finish it and start adding the existing docs. On a related note, What do you think of creating links to the tutorals and placing them all in the hierarchy? Regards, David From Tom Deprez" Hi, A publisher contacted me about writing a book. After lots of thought, I decided to give it a try and I'm now starting to work on the proposal. Of course, the publisher still has to agree my proposal, before I can really say that I'm writing a book for Zope. And this can still take some time or even never happen. One point is that this book won't be open-source, sorry. I hope that I don't hit people on their foot by doing this. I'm still working on ZDP (I think ZDP will even benefit more from it). I hope that ZDP people want to help me on this. Perhaps I even need some people to help writing on some chapters (thus getting really involved into it). Tom. From rik.hoekstra@inghist.nl Tue Apr 4 09:06:58 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Tue, 04 Apr 2000 10:06:58 +0200 Subject: [ZDP] Learning DTML - an addition to ZBook References: <38E8C055.CCF9F536@op.net> Message-ID: <38E9A2A2.B85696DE@inghist.nl> Eron Lloyd wrote: > > Hey hey hey! Ok, I've decided to work on a thorough study of DTML, and > add it to ZBook. I don't know how well it will flow at first, but that's > the beauty of write, edit, rewrite, revise :-) Anybody that wants to > look at what I wrote feel free to contact me. Currently, I've come up > with somewhat of a structure: Structure looks ok, but see Kamon's mail. One other thing: could you please add any snippets of dtml code to the ZSnippets, also at the ZDP site. In this way they are also available for use for other purposes and for people who do not want to work through your text, but who are just looking for examples to work with. Rik From tom.deprez@uz.kuleuven.ac.be Tue Apr 4 12:13:43 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Tue, 04 Apr 2000 13:13:43 +0200 Subject: [ZDP] guidelines Message-ID: <3.0.6.32.20000404131343.00926ba0@poirot> Hi, I'm working on the guidelines for publishing a draft in ZBook. Please read the following very quickly written draft. Add some comments with it and replace the ?-marks with the correct answer. Thanks! Contributing to ZBook --------------------- Here follows some guidelines to succesfully add a draft to ZBook. Assumptions ----------- * You know the basics of the Zope web-interface. i.e. You know how to add/edit objects in Zope. * You are a member of ZDP and thus have a login and password to ZDP. Intro ----- ZCL --- The ZCL is the framework of ZBook. ZCL is in fact the future of ZBook, it describes which chapters will be included. If you want to contribute to ZBook, please look at the ZCL. Here you'll find the chapters of ZBook and their place in the hierarchy. ZCL is also the place where ZBook is being discussed. Do you want a certain chapter included in ZBook, then propose it to the ZCL. ZBook ----- ZBook tries to mimic the ZCL. One day, they both will look the same with the difference of course that ZBook not only contains chapter-titles, but also content. (This also means that ZDP has to start with a new book :-) ) If you're not certain where a certain draft has to be placed in ZBook, you'll probably find the right answer in the ZCL. ZBook consists of several classes. Most likely you'll only work with some of the classes frequently. ZBook is a hierarchy on itself, with 'folder' classes which can contain other 'folder' and 'non-folder' classes. The 'root' of ZBook is the 'Book-Class'. The 'Book-Class' contains 'Part-Classes' which on their turn contain 'Chapter-Classes'. The contents of a 'Chapter-Class' varies. It can either contain 'Chapter-Classes' or a 'DraftSubmissionFolder-Class' and/or a 'CommentFolder-Class'. Thus putting this in a schematical view, we get this : Book Part Chapter (Chapter) CommentFolder DraftSubmissionFolder Mostly, we'll only have to work with the last three classes, for now... until we start with ZBook Advanced, of course! Publishing a Draft ------------------ Adding a Chapter ---------------- If you follow the ZCL -which is recommended-, then it's almost certain that the Chapter you're writing for already exists ZBook's hierarchy. If this is so, than you can just skip this paragraph. If it doesn't exists, you've to create it. To do so, browse to the lowest level -that you can- in the Zope hierarchy. This is the 'Part' -or a 'Chapter' in which you're 'Chapter' will be part of. At this level, add a 'Chapter' object. Fill in the properties Zope will ask you to do so. All the properties are commented, so you'll know for what they are going to be used. You're totally free to fill in these properties to your own will, however we ask you to follow the following guideline : ChapterID: Use a short title description (spaces-excluded) of the Chapter-title eg 'Zope's Object Publishing' becomes 'ObjectPublishing' Adding a DraftSubmissionFolder ------------------------------ If you add a new chapter, you also have to add a 'DraftSubmissionFolder'. This folder will hold all drafts concerning this chapter. In the chapter, you add a 'DraftSubmissionFolder' object. Again, a form will guide you through the properties which Zope asks you to fill in. Please, try to follow the following guideline: DraftSubmissionFolderID: ??? Adding a CommentFolder ---------------------- If you want people to be able to add comments, you'll have to add a 'CommentFolder' to this chapter. As the name of the class says, this folder will hold all comments for this chapter. To do so, in the chapter, add a 'CommentFolder' object. Again, a form will guide you through the properties which Zope asks you to fill in. Please, try to follow the following guideline: CommentFolderID: ??? Adding a Draft -------------- For adding a draft, browse to the Chapter in which the draft will reside. Go to the 'DraftSubmissionFolder', which should exist by now. (If not, go to Adding a DraftSubmissionFolder) In the DraftSubmissionFolder add a 'Draft' object. Again, a form will guide you through the properties which Zope asks you to fill in. Please, try to follow the following guideline: DraftID: ??? Tip: You can change the abstract of the Draft object by going to the 'DraftInfo' view of a Draft object. Special properties ------------------ All classes in ZDP, contain 'special' properties. You can change them by entering the 'EditInfo view'. NeedsReaders If set to 1, the content is viewable NeedsCommenters If set to 1, the content can be commented NeedsWriters If set to 1, ZDP needs people who want to write on the topic NeedsReviewers If set to 1, the contents need to be reviewed NeedsApprovers If set to 1, the contents need to be approved NeedsMaintainers If set to 1, ZDP needs a person who wants to maintain the content type Shows the type of the object. In our case it can be a Book, Part, Chapter, DraftSubmissionFolder, CommentFolder, Draft, Comment category ? keyword ? Maintainer Displays the ZDP member which maintains the contents nickname Shows nickname of object name Shows name of object content_type Shows how the content of the object has to be interpreted categories ? contextorder ? contextorder From woodsage@op.net Tue Apr 4 03:15:02 2000 From: woodsage@op.net (Eron Lloyd) Date: Mon, 03 Apr 2000 22:15:02 -0400 Subject: [ZDP] Learning DTML - an addition to ZBook References: <20000404092957.38543.qmail@hotmail.com> Message-ID: <38E95026.795D2266@op.net> It seems that he had completed a "DTML Methods" section in Application Developement, but I don't see a draft anywhere. I guess I could take that section and break it down into smaller components. Maybe we can get a hold of him. The thing I want to do is to examine the best path to present DTML to the "new user" - one without Python or Web application development experience. This should be well-defined before we even get started. Take care, Eron P.S. - if ANYBODY wants to talk about this, I'll be in EFNet's #zope channel all day. We should really have a better medium (besides the mailing-lists) to collaborate on Zope development. From michel@digicool.com Tue Apr 4 18:34:13 2000 From: michel@digicool.com (Michel Pelletier) Date: Tue, 04 Apr 2000 10:34:13 -0700 Subject: [ZDP] The Interfaces Wiki Message-ID: <38EA2795.B8416553@digicool.com> The Interfaces Wiki is coming along fast! But we need your input. Please take a moment to stop by the Wiki and read the latest developments, RecentChanges is allways a good place to start: http://www.zope.org/Members/michel/Projects/Interfaces -Michel From kankie@thegrid.net Tue Apr 4 20:36:04 2000 From: kankie@thegrid.net (David Kankiewicz) Date: Tue, 04 Apr 2000 12:36:04 -0700 Subject: [ZDP] guidelines References: <3.0.6.32.20000404131343.00926ba0@poirot> Message-ID: <38EA4424.54E382AB@thegrid.net> Tom Deprez wrote: > > Hi, > > I'm working on the guidelines for publishing a draft in ZBook. Please read > the following very quickly written draft. Add some comments with it and > replace the ?-marks with the correct answer. Thanks! > Special properties > ------------------ > category ? Currently used in Snippets (only?) for the different sections (no real purpose for them). > keyword ? Unused. (Will be used for 'canned' related searches unless someone comes up with a better use...) > categories ? Used for my hierarchy, tokens hold multiple placement items... *Use [Edit Categories]* to edit it... (the hierarchy will be usable *after* the 6th..) > contextorder ? Use [Edit Content Order], I think... Done by Rik Hoekstra AFAIK. Regards, David From kayeva@hotmail.com Wed Apr 5 10:13:34 2000 From: kayeva@hotmail.com (kamon ayeva) Date: Wed, 05 Apr 2000 09:13:34 GMT Subject: [ZDP] guidelines Message-ID: <20000405091334.68854.qmail@hotmail.com> Hi Tom, See my comments... > >Contributing to ZBook >--------------------- > >Here follows some guidelines to succesfully add a draft to ZBook. > >Assumptions >----------- > >* You know the basics of the Zope web-interface. i.e. You know how to >add/edit objects in Zope. >* You are a member of ZDP and thus have a login and password to ZDP. > >Intro >----- > >ZCL >--- > >The ZCL is the framework of ZBook. ZCL is in fact the future of ZBook, it >describes which chapters will be included. >If you want to contribute to ZBook, please look at the ZCL. Here you'll >find the chapters of ZBook and their place in the hierarchy. >ZCL is also the place where ZBook is being discussed. Do you want a certain >chapter included in ZBook, then propose it to the ZCL. > >ZBook >----- > >ZBook tries to mimic the ZCL. One day, they both will look the same with >the difference of course that ZBook not only contains chapter-titles, but >also content. >(This also means that ZDP has to start with a new book :-) ) >If you're not certain where a certain draft has to be placed in ZBook, >you'll probably find the right answer in the ZCL. > >ZBook consists of several classes. Most likely you'll only work with some >of the classes frequently. >ZBook is a hierarchy on itself, with 'folder' classes which can contain >other 'folder' and 'non-folder' classes. >The 'root' of ZBook is the 'Book-Class'. The 'Book-Class' contains >'Part-Classes' which on their turn contain 'Chapter-Classes'. >The contents of a 'Chapter-Class' varies. It can either contain >'Chapter-Classes' or a 'DraftSubmissionFolder-Class' and/or a >'CommentFolder-Class'. Here the Content provider is not necessarily a full techie (even if in reality we are all interested by the technical aspects). I propose to replace the term "class" by "template" which talks better to most people. >Thus putting this in a schematical view, we get this : > >Book > Part > Chapter > (Chapter) > CommentFolder > DraftSubmissionFolder > >Mostly, we'll only have to work with the last three classes, for now... >until we start with ZBook Advanced, of course! > >Publishing a Draft >------------------ > >Adding a Chapter >---------------- > >If you follow the ZCL -which is recommended-, then it's almost certain that >the Chapter you're writing for already exists ZBook's hierarchy. >If this is so, than you can just skip this paragraph. > >If it doesn't exists, you've to create it. To do so, browse to the lowest >level -that you can- in the Zope hierarchy. >This is the 'Part' -or a 'Chapter' in which you're 'Chapter' will be part >of. >At this level, add a 'Chapter' object. Fill in the properties Zope will ask >you to do so. >All the properties are commented, so you'll know for what they are going to >be used. You're totally free to fill in these properties to your own will, >however we ask >you to follow the following guideline : > > ChapterID: Use a short title description (spaces-excluded) of the >Chapter-title > eg 'Zope's Object Publishing' becomes >'ObjectPublishing' > >Adding a DraftSubmissionFolder >------------------------------ > >If you add a new chapter, you also have to add a 'DraftSubmissionFolder'. >This folder will hold all drafts concerning this chapter. > >In the chapter, you add a 'DraftSubmissionFolder' object. Again, a form >will guide you through the properties which Zope asks you to fill in. >Please, try to follow the following guideline: > > DraftSubmissionFolderID: ??? I used to just put "Drafts" as the ID, the name and the nickname. > >Adding a CommentFolder >---------------------- > >If you want people to be able to add comments, you'll have to add a >'CommentFolder' to this chapter. >As the name of the class says, this folder will hold all comments for this >chapter. > >To do so, in the chapter, add a 'CommentFolder' object. Again, a form will >guide you through the properties which Zope asks you to fill in. >Please, try to follow the following guideline: > > CommentFolderID: ??? I would put "short/contracted description of the comment" but I am not sure if it is the best. >Adding a Draft >-------------- > >For adding a draft, browse to the Chapter in which the draft will reside. >Go to the 'DraftSubmissionFolder', which should exist by now. (If not, go >to Adding a DraftSubmissionFolder) > >In the DraftSubmissionFolder add a 'Draft' object. Again, a form will guide >you through the properties which Zope asks you to fill in. >Please, try to follow the following guideline: > > DraftID: Could be "the related chapterID" + "draft" (ended by draft), and for new drafts, increment ...draft1, ...draft2, and so one. > >Tip: > >You can change the abstract of the Draft object by going to the 'DraftInfo' >view of a Draft object. > Regards, Kamon kayeva@hotmail.com ______________________________________________________ Get Your Private, Free Email at http://www.hotmail.com From kayeva@hotmail.com Wed Apr 5 10:30:00 2000 From: kayeva@hotmail.com (kamon ayeva) Date: Wed, 05 Apr 2000 09:30:00 GMT Subject: [ZDP] Learning DTML - an addition to ZBook Message-ID: <20000405093000.90248.qmail@hotmail.com> Hi Eron, Yes, we need to contact Dody so that he could handover his drafts (the latest version) to other people. But I don't know how to contact him. if anyone else ? I remember he started with a presentation of DTML tags and how to use them. So there is no reason you could not rework that as a beginners level material. Btw, have you already got a structure for your chapter ? We could change "III. Application Development" a bit accordingly. >P.S. - if ANYBODY wants to talk about this, I'll be in EFNet's #zope >channel >all day. We should really have a better medium (besides the mailing-lists) >to >collaborate on Zope development. I am sorry but I was unable to find your channel. Do I need to register on the site before ? Cheers, Kamon ______________________________________________________ Get Your Private, Free Email at http://www.hotmail.com From woodsage@op.net Wed Apr 5 17:16:54 2000 From: woodsage@op.net (Eron Lloyd) Date: Wed, 05 Apr 2000 12:16:54 -0400 Subject: [ZDP] Learning DTML - an addition to ZBook References: <20000405093000.90248.qmail@hotmail.com> Message-ID: <38EB66F6.ED67FA1C@op.net> kamon ayeva wrote: > Hi Eron, > > Yes, we need to contact Dody so that he could handover his drafts (the > latest version) to other people. But I don't know how to contact him. if > anyone else ? > I remember he started with a presentation of DTML tags and how to use them. > So there is no reason you could not rework that as a beginners level > material. > Btw, have you already got a structure for your chapter ? We could change > "III. Application Development" a bit accordingly. > > >P.S. - if ANYBODY wants to talk about this, I'll be in EFNet's #zope > >channel > >all day. We should really have a better medium (besides the mailing-lists) > >to > >collaborate on Zope development. > > I am sorry but I was unable to find your channel. Do I need to register on > the site before ? > > Cheers, > Kamon > ______________________________________________________ > Get Your Private, Free Email at http://www.hotmail.com Hello, Kamon. I could definitely work with whatever is already available. Maybe Tom Deprez may know how to contact Dody? At any rate, I'm really taking a long hard look at everything available on DTML right now - I DO seriously want to exchange some dialogue (even if on this list) about all the nuances for DTML - I think a lot of feedback would help immensely, even from DC. Usually I'm on EFNet's #zope channel (if it isn't there, then no one's in it). In order for this project to grow, we definitely need some more groupware tools (besides the wonderful ZDP site). Let's hope HelixCode releases Evolution soon ;-)..... Keep in touch, Eron From jorgen.skogstad@getronics.no Thu Apr 6 09:20:53 2000 From: jorgen.skogstad@getronics.no (jorgen.skogstad@getronics.no) Date: Thu, 6 Apr 2000 10:20:53 +0200 Subject: [ZDP] Newbie question -> *.zexp files for ZDP tools.. Message-ID: Kindest .. I am getting into Zope and would like to take a look at the ZDP tools package, but I cannot get the documentation or the ZDP tools package uncompressed. They are publically available .. but are in zexp format .. for which I have only seen a comercial uncompress engine. Could anyone advise me how to get further .. so I can take a look at this neat little project? Thanks in advance. Have a real nice day. Kindest, Jřrgen Skogstad From rik.hoekstra@inghist.nl Thu Apr 6 09:05:18 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Thu, 6 Apr 2000 10:05:18 +0200 Subject: [ZDP] Newbie question -> *.zexp files for ZDP tools.. Message-ID: <002201bf9f9e$da765320$fe5da182@etgriend.et.tudelft.nl> -----Original Message----- From: jorgen.skogstad@getronics.no To: zdp@zope.org Date: donderdag 6 april 2000 9:24 Subject: [ZDP] Newbie question -> *.zexp files for ZDP tools.. Kindest .. I am getting into Zope and would like to take a look at the ZDP tools package, but I cannot get the documentation or the ZDP tools package uncompressed. They are publically available .. but are in zexp format .. for which I have only seen a comercial uncompress engine. Could anyone advise me how to get further .. so I can take a look at this neat little project? [rh]look at http://www.zope.org/Members/roeder Note, however, that there have been some changes on the original zdptools by other ZDP members after Maik released them. Rik From tom.deprez@uz.kuleuven.ac.be Thu Apr 6 17:25:20 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Thu, 06 Apr 2000 18:25:20 +0200 Subject: [ZDP] Learning DTML - an addition to ZBook In-Reply-To: <38EB66F6.ED67FA1C@op.net> References: <20000405093000.90248.qmail@hotmail.com> Message-ID: <3.0.6.32.20000406182520.0091a770@poirot> Hi All, I've an e-mail address of Dody : Dody Gunawinata Doesn't Dody replies if you send a mail? Tom. At 12:16 05/04/2000 -0400, Eron Lloyd wrote: >kamon ayeva wrote: > >> Hi Eron, >> >> Yes, we need to contact Dody so that he could handover his drafts (the >> latest version) to other people. But I don't know how to contact him. if >> anyone else ? >> I remember he started with a presentation of DTML tags and how to use them. >> So there is no reason you could not rework that as a beginners level >> material. >> Btw, have you already got a structure for your chapter ? We could change >> "III. Application Development" a bit accordingly. >> >> >P.S. - if ANYBODY wants to talk about this, I'll be in EFNet's #zope >> >channel >> >all day. We should really have a better medium (besides the mailing-lists) >> >to >> >collaborate on Zope development. >> >> I am sorry but I was unable to find your channel. Do I need to register on >> the site before ? >> >> Cheers, >> Kamon >> ______________________________________________________ >> Get Your Private, Free Email at http://www.hotmail.com > >Hello, Kamon. I could definitely work with whatever is already available. >Maybe Tom Deprez may know how to contact Dody? At any rate, I'm really taking >a long hard look at everything available on DTML right now - I DO seriously >want to exchange some dialogue (even if on this list) about all the nuances >for DTML - I think a lot of feedback would help immensely, even from DC. >Usually I'm on EFNet's #zope channel (if it isn't there, then no one's in it). >In order for this project to grow, we definitely need some more groupware >tools (besides the wonderful ZDP site). >Let's hope HelixCode releases Evolution soon ;-)..... > >Keep in touch, > >Eron > > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From tom.deprez@uz.kuleuven.ac.be Thu Apr 6 17:28:03 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Thu, 06 Apr 2000 18:28:03 +0200 Subject: [ZDP] Newbie question -> *.zexp files for ZDP tools.. In-Reply-To: Message-ID: <3.0.6.32.20000406182803.0091fca0@poirot> Hi Jorgen, ... zexp format is the format in which we can export Zope Products. To install them on your Zope site, just download them and from the products page (of Zope), choose import and point to the downloaded file. Regards, Tom. At 10:20 06/04/2000 +0200, jorgen.skogstad@getronics.no wrote: > >Kindest .. > >I am getting into Zope and would like to take a look at the ZDP tools package, >but I cannot get the documentation or the ZDP tools package uncompressed. >They are publically available .. but are in zexp format .. for which I have only >seen a comercial uncompress engine. > >Could anyone advise me how to get further .. so I can take a look at this >neat little project? > >Thanks in advance. > >Have a real nice day. > >Kindest, >Jřrgen Skogstad > > > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From Amos@digicool.com Fri Apr 7 02:17:21 2000 From: Amos@digicool.com (Amos Latteier) Date: Thu, 6 Apr 2000 21:17:21 -0400 Subject: [ZDP] ANNOUNCE: Zope Tutorial Preview Message-ID: <613145F79272D211914B0020AFF64019320527@gandalf.digicool.com> Hi, I've been working on an interactive Zope tutorial for new users. I'm at the point where I'd like some feedback. http://www.zope.org/Documentation/Projects/Tutorial/ You can download the tutorial, install it in Zope and read it online while you follow along in the management interface. The tutorial is not finished or polished, but I think that you can get a pretty good idea of the flavor from what's done now. My plan is to expand and tune the tutorial more, and then include with Zope at the next major release (which will also include the online help system). The tutorial will be part of the standard help content and will be available immediately after you install Zope. (Even though the tutorial will ship with Zope, the tutorial content will be upgradeable without reinstalling Zope.) Thanks for your feedback! -Amos P.S. If you are interested in authoring a lesson or two let me know, I'd love to include it in the tutorial. It's not a large commitment, and you get the glory of having your stuff in the standard Zope distribution! -- Amos Latteier mailto:amos@digicool.com Digital Creations http://www.digicool.com From rik.hoekstra@inghist.nl Fri Apr 7 10:38:16 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Fri, 07 Apr 2000 11:38:16 +0200 Subject: [ZDP] ANNOUNCE: Zope Tutorial Preview References: <613145F79272D211914B0020AFF64019320527@gandalf.digicool.com> Message-ID: <38EDAC88.7E37F1ED@inghist.nl> Amos Latteier wrote: > > Hi, > > I've been working on an interactive Zope tutorial for new users. I'm at > the point where I'd like some feedback. > > http://www.zope.org/Documentation/Projects/Tutorial/ > > You can download the tutorial, install it in Zope and read it online > while you follow along in the management interface. Amos, the example thing won't import (Zope 2.1.4, could this be the problem). THe product shows broken images, but that's perhaps just roughness > > The tutorial is not finished or polished, but I think that you can get a > pretty good idea of the flavor from what's done now. perhaps if it worked ;-) > > My plan is to expand and tune the tutorial more, and then include with > Zope at the next major release (which will also include the online help > system). The tutorial will be part of the standard help content and will > be available immediately after you install Zope. (Even though the > tutorial will ship with Zope, the tutorial content will be upgradeable > without reinstalling Zope.) > > Thanks for your feedback! > > -Amos > > P.S. If you are interested in authoring a lesson or two let me know, I'd > love to include it in the tutorial. It's not a large commitment, and you > get the glory of having your stuff in the standard Zope distribution! > I would like to. Do you have a wishlist? Rik From rik.hoekstra@inghist.nl Fri Apr 7 10:41:24 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Fri, 07 Apr 2000 11:41:24 +0200 Subject: [ZDP] ANNOUNCE: Zope Tutorial Preview References: <613145F79272D211914B0020AFF64019320527@gandalf.digicool.com> <38EDAC88.7E37F1ED@inghist.nl> Message-ID: <38EDAD44.67E60985@inghist.nl> > > Amos Latteier wrote: > > > > Hi, > > > > I've been working on an interactive Zope tutorial for new users. I'm at > > the point where I'd like some feedback. > > > > http://www.zope.org/Documentation/Projects/Tutorial/ > > > > You can download the tutorial, install it in Zope and read it online > > while you follow along in the management interface. > > Amos, the example thing won't import (Zope 2.1.4, could this be the > problem). Woops, forgot the traceback: Error Type: TypeError
Error Value: ('len() of unsized object', , None)

[snip] Rik From kayeva@hotmail.com Fri Apr 7 12:18:11 2000 From: kayeva@hotmail.com (kamon ayeva) Date: Fri, 07 Apr 2000 11:18:11 GMT Subject: [ZDP] Learning DTML - an addition to ZBook Message-ID: <20000407111811.72534.qmail@hotmail.com> Thanks. I would try to contact him. Except if someone has already done, let me know. --Kamon >From: Tom Deprez >To: Eron Lloyd , kamon ayeva , >zdp@zope.org >Subject: Re: [ZDP] Learning DTML - an addition to ZBook >Date: Thu, 06 Apr 2000 18:25:20 +0200 > >Hi All, > >I've an e-mail address of Dody : Dody Gunawinata > >Doesn't Dody replies if you send a mail? > >Tom. ______________________________________________________ Get Your Private, Free Email at http://www.hotmail.com From Amos@digicool.com Fri Apr 7 21:18:29 2000 From: Amos@digicool.com (Amos Latteier) Date: Fri, 7 Apr 2000 16:18:29 -0400 Subject: [ZDP] ANNOUNCE: Zope Tutorial Preview Message-ID: <613145F79272D211914B0020AFF6401932052A@gandalf.digicool.com> > > Amos, the example thing won't import (Zope 2.1.4, could this be the > > problem). > > > Woops, forgot the traceback: > > Error Type: TypeError
> Error Value: ('len() of unsized object', Shared.DC.ZRDB.DA.SQL at add2e0>, None)
>

> > [snip] >

http://www.zope.org//

Date:

Author:

Tip:

Details:

------------------------------------------------------------------ tips_in_xml: ------------------------------------------------------------------ / ------------------------------------------------------------------ From tom.deprez@uz.kuleuven.ac.be Wed Apr 12 11:17:30 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Wed, 12 Apr 2000 12:17:30 +0200 Subject: [ZDP] A new Comment has been added to ZDP ! In-Reply-To: <38F44797.4455A7EA@axion-gmbh.de> Message-ID: <3.0.6.32.20000412121730.00973100@poirot> Mmm, if someone installed ZDP, isn't it then strange that we receive this URL: http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions/comment/9554 59351/CommentClass_factory Tom At 10:53 12/04/2000 +0100, Maik Röder wrote: >Hi Tom ! > >Is someone playing around? > >Please have a look at the Mail source and look exactly where the mail >is coming from. Maybe someone has installed the ZDP-Tools on their >computer and has tried it out. > >Greetings, > >Maik > >Tom. > >>Date: Tue, 11 Apr 2000 15:34:20 +0200 (MET DST) >>To: Tom Deprez >>From: The CommentClass constructor >>Subject: A new Comment has been added to ZDP ! >> >>Dear Tom ! >> >>Under the following URL, a Comment has been added: >> >>URL: >http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions/comment/9554 >59351/CommentClass_factory >> >>Name: sfsdf >> >>Nickname: sfsdf >> >>Content: >>udkudgk, >> >>Have a nice day, >> >>The CommentClass constructor >>(http://zdp.zope.org/Control_Panel/Products/DocumentFolderProduct/CommentCl >ass_add/manage_main) >> >> >> >> > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From roeder@berg.net Wed Apr 12 19:33:01 2000 From: roeder@berg.net (Maik Roeder) Date: Wed, 12 Apr 2000 20:33:01 +0200 Subject: [ZDP] A new Comment has been added to ZDP ! References: <3.0.6.32.20000412121730.00973100@poirot> Message-ID: <38F4C15D.9514508E@berg.net> Hi Tom ! Tom Deprez wrote: > > Mmm, if someone installed ZDP, isn't it then strange that we receive this > URL: > http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions/comment/9554 > 59351/CommentClass_factory Turns out it's been one of my colleages at Axion, called Manfred (He is the member under http://zdp.zope.org/members/mabruk ). We had tested some code in a private session. This was an extension to the CommentClass to test threaded discussions, so it turns out he has added this comment for testing purposes. Sorry for the confusion ! Greetings, Maik From slager@hydra.accu.uu.nl Thu Apr 13 04:52:17 2000 From: slager@hydra.accu.uu.nl (Felix Slager) Date: Thu, 13 Apr 2000 05:52:17 +0200 Subject: [ZDP] ZDP Site Feedback Message-ID: <38F54471.F06610D4@hydra.accu.uu.nl> Early morning bird Zope server down - but! lucky me, there's always the ZDP... From kayeva@hotmail.com Fri Apr 14 12:03:20 2000 From: kayeva@hotmail.com (kamon ayeva) Date: Fri, 14 Apr 2000 11:03:20 GMT Subject: [ZDP] How-tos mirror links Message-ID: <20000414110320.59502.qmail@hotmail.com> Great. I will work from this. Thanks. Kamon >From: Maik Röder >To: zdp@zope.org >Subject: [ZDP] How-tos mirror links >Date: Wed, 12 Apr 2000 11:01:40 +0100 > >Hi Kamon ! > > > I propose myself for working on the Zope.org how-tos links system. > > I will come back later with some proposal. > >I already have something which you may want to use. It is an HTML >and XML view of the Tips on Zope.org. This can be easily >adapted to the How-Tos. I had been thinking about parsing the >XML file and uploading it to ZDP via ZClient. > >You can try the scripts out live on the Zope.org site: > >http://www.zope.org/Members/roeder/tips_in_html >http://www.zope.org/Members/roeder/tips_in_xml > >I have also pasted the scripts below ... > >Greetings, > >Maik > >------------------------------------------------------------------ >tips_in_html: >------------------------------------------------------------------ > > > > > > > > > >


>
    > > >
  • > > >
> > > > > >
> >
>

> >http://www.zope.org// > >

>Date: >

>Author: >

> >Tip: >

> >

>Details: >

> >

> > > > > > > > >------------------------------------------------------------------ >tips_in_xml: >------------------------------------------------------------------ > > > > > > > > > > > > > / > > > > > > > > > > > > > > > > > > > > > > > > > > > > > >------------------------------------------------------------------ > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > ______________________________________________________ Get Your Private, Free Email at http://www.hotmail.com From tom.deprez@uz.kuleuven.ac.be Fri Apr 14 13:56:30 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Fri, 14 Apr 2000 14:56:30 +0200 Subject: [ZDP] class descending of folderclass Message-ID: <3.0.6.32.20000414145630.00922c80@poirot> Hi, I've made a class, which descends form Catalogaware and folderclass. The problem is that I can't use the dtml-tree correctly. It doesn't shows my instances as nodes (ie with a expand/collapse button). Same as I look at my instances in the tree of the zope interface. Do I've to do something special? Tom. From roeder@berg.net Fri Apr 14 17:11:25 2000 From: roeder@berg.net (Maik.Röder) Date: Fri, 14 Apr 2000 18:11:25 +0200 Subject: [ZDP] class descending of folderclass References: <3.0.6.32.20000414145630.00922c80@poirot> Message-ID: <38F7432D.1C2F4308@berg.net> Hi Tom ! > I've made a class, which descends form Catalogaware and folderclass. > > The problem is that I can't use the dtml-tree correctly. > It doesn't shows my instances as nodes (ie with a expand/collapse button). > > Same as I look at my instances in the tree of the zope interface. > > Do I've to do something special? Perhaps you can take a look at my implementation of the DiscussionFolder: "> There is no expand/collapse involved here, but the nodes are displayed alright at: http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions/discussion BTW: Any comments on the Threaded Discussion task ? http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions/ Greetings, Maik From Paul@digicool.com Sat Apr 15 14:30:59 2000 From: Paul@digicool.com (Paul Everitt) Date: Sat, 15 Apr 2000 09:30:59 -0400 Subject: [ZDP] ANNOUNCE: Zope Tutorial 1.0a3 Message-ID: <613145F79272D211914B0020AFF640192633D1@gandalf.digicool.com> Amos wrote: > I've revved the Zope Tutorial again. Now the RDBMS lesson > should work. > > http://www.zope.org/Documentation/Projects/Tutorial > > I'd like to know if anyone has problems installing and using the > tutorial. Ugh, it's a shame that the ZDP isn't providing much feedback on this. ZDP crowd, do you think Amos should keep with his policy of asking you for comments before going to the main Zope list? Anyway, here's the beginning of my comments. Comments on Amos' Tutorial Material First, boy, the URL to access it the tutorial is pretty buried! Obviously people will do something closer to "click on help, then click on tutorials", right? The tutorial doesn't have much of a cover page, something that explains how tutorials work, who they are for, etc. Obviously the presentation in HTML is pretty bland, it's just the default rendering. Is it a goal of the tutorials to have them be visually engaging, a la XML.com articles? The jump into Lesson 1 is pretty jarring. Where did "Elvis Lives" come from? Perhaps a single page that sets the scene about the fictional organization, then describes the kinds of things needed in the site. I like having the code boxes be in a different color. It's important to let people know how many more lessons there are. Is there some way to avoid discussion of 'index_html'? Can you just make it 'home.html'? Since few have ever seen the '_html' style, they will be presented with a new concept. Though (until we fix Zope) they'll need to know about 'index_html', that Zen should be postponed. They should be kept close to what they already know. On '1. Change the...' the line ends with a double colon. Structured text should have converted that to a single colon for display, right? Near the top of Lesson 1, you have 'First you need...' In that line you have 'DTML Documents' with the 's' in documents as part of the fixed font. It implies that the 'DTML Documents' is a concept, rather than 'DTML Document'. Later under Summary you do the right thing, having _DTML Document_s for a hyperlink. Man, this is good. The use of a glossary is just earth shattering. Is the glossary associated with the help system _globally_ (hope so!) or just with the tutorials? I'd like to see a central glossary in the help system. Change the last paragraph to something like: Congratulations, you've created a web page with Zope. In the next step, That is, set the scene briefly for the next page. Perhaps it's just me, but the navigation buttons seem oddly placed. I wonder if they should be left justified. In Lesson 2, the first paragraph has a grammar error. How about: Elvis loved his home, Graceland. Let's link an existing page to our web site with information about Graceland. I like that you chose 'graceland' for the folder id instead of 'Graceland'. I wonder if camel case in Zope should be a style that is deprecated. I think the Lesson 2 page should reiterate the explanation of DTML tags. A note at this point. The text is extremely terse, as opposed to an XML.com article. Does everybody think that this is the right approach? I do, but more feedback is appreciated. I think that 'id' and 'title' should be glossary entries. In the 'id' entry you can explain the rules for valid characters. In 'title', you can explain that it is optional, and 'title_or_id' is the preferred way to access it. From Anthony Baxter Sat Apr 15 14:45:42 2000 From: Anthony Baxter (Anthony Baxter) Date: Sat, 15 Apr 2000 23:45:42 +1000 Subject: [ZDP] ANNOUNCE: Zope Tutorial 1.0a3 In-Reply-To: Message from Paul Everitt of "Sat, 15 Apr 2000 09:30:59 -0400." <613145F79272D211914B0020AFF640192633D1@gandalf.digicool.com> Message-ID: <200004151345.XAA17720@mbuna.arbhome.com.au> >>> Paul Everitt wrote > Ugh, it's a shame that the ZDP isn't providing much feedback on this. > ZDP crowd, do you think Amos should keep with his policy of asking you > for comments before going to the main Zope list? I had another quick go at installing it, got the same error, and planned to try and diagnose it further... -- Anthony Baxter It's never too late to have a happy childhood. From paul@digicool.com Sat Apr 15 15:44:56 2000 From: paul@digicool.com (Paul Everitt) Date: Sat, 15 Apr 2000 10:44:56 -0400 Subject: [ZDP] ANNOUNCE: Zope Tutorial 1.0a3 References: <200004151345.XAA17720@mbuna.arbhome.com.au> Message-ID: <38F88068.6EC73F3A@digicool.com> That's odd. I simply untar'd Zope 2.1.6, did an install, and installed Amos' stuff w/out a hitch. --Paul Anthony Baxter wrote: > > >>> Paul Everitt wrote > > Ugh, it's a shame that the ZDP isn't providing much feedback on this. > > ZDP crowd, do you think Amos should keep with his policy of asking you > > for comments before going to the main Zope list? > > I had another quick go at installing it, got the same error, and > planned to try and diagnose it further... > > -- > Anthony Baxter > It's never too late to have a happy childhood. From Tom Deprez" Message-ID: <003f01bfa6eb$04125960$0101a8c0@paladin> > Ugh, it's a shame that the ZDP isn't providing much feedback on this. > ZDP crowd, do you think Amos should keep with his policy of asking you > for comments before going to the main Zope list? Hey, I sended several mails to Amos for feedback, I only don't know if they all arrived. I didn't sended all of them to the ZDP (only for the one getting the tutorial installed, because I saw that it gave some problems) Tom. From Anthony Baxter Sun Apr 16 03:46:13 2000 From: Anthony Baxter (Anthony Baxter) Date: Sun, 16 Apr 2000 12:46:13 +1000 Subject: [ZDP] ANNOUNCE: Zope Tutorial 1.0a3 In-Reply-To: Message from Paul Everitt of "Sat, 15 Apr 2000 10:44:56 -0400." <38F88068.6EC73F3A@digicool.com> Message-ID: <200004160246.MAA19566@mbuna.arbhome.com.au> Ah - I don't think I'm running 2.1.6 yet. I need to understand the changes to Acquisition, and figure out how they affect some existing in-house Products (one in particular is almost certainly going to be broken by it... :-( Anthony >>> Paul Everitt wrote > > That's odd. I simply untar'd Zope 2.1.6, did an install, and installed > Amos' stuff w/out a hitch. > > --Paul > > Anthony Baxter wrote: > > > > >>> Paul Everitt wrote > > > Ugh, it's a shame that the ZDP isn't providing much feedback on this. > > > ZDP crowd, do you think Amos should keep with his policy of asking you > > > for comments before going to the main Zope list? > > > > I had another quick go at installing it, got the same error, and > > planned to try and diagnose it further... > > > > -- > > Anthony Baxter > > It's never too late to have a happy childhood. > -- Anthony Baxter It's never too late to have a happy childhood. From rik.hoekstra@inghist.nl Sun Apr 16 20:21:27 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Sun, 16 Apr 2000 21:21:27 +0200 Subject: [ZDP] ANNOUNCE: Zope Tutorial 1.0a3 Message-ID: <001901bfa7d8$f73feec0$fe5da182@etgriend.et.tudelft.nl> > >Amos wrote: >> I've revved the Zope Tutorial again. Now the RDBMS lesson >> should work. >> >> http://www.zope.org/Documentation/Projects/Tutorial >> >> I'd like to know if anyone has problems installing and using the >> tutorial. > >Ugh, it's a shame that the ZDP isn't providing much feedback on this. >ZDP crowd, do you think Amos should keep with his policy of asking you >for comments before going to the main Zope list? > I think it's a good idea asking feedback. I have just been ill and didn't have time to look into it in any detail (sorry). The second version of the tutorial installed alright, and it looked quite good. I wanted to try it out on someone at work who is starting Zope just now. Just need a little time. But in the meantime, Amos, go ahead. I agree with Paul's comments about reachability. I _think_ you already need to know quite a bit about Zope to get the thing started. Couldn't you consider a custom data.fs distributrion with the tutorial installed already with an option with install to make this a dummy for starters in Zope? Or a remote url (at zope.org) that walks you through to get you started? Rik From rik.hoekstra@inghist.nl Sun Apr 16 21:00:17 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Sun, 16 Apr 2000 22:00:17 +0200 Subject: [ZDP] class descending of folderclass Message-ID: <00c101bfa7de$63efc720$fe5da182@etgriend.et.tudelft.nl> >BTW: Any comments on the Threaded Discussion task ? > >http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions/ > Hi Maik, I had some comments, but added them to the discussion page (didn't know whether you'd be notified). A few additional questions. Is the goal anything squishdot like, or much simpler? If the first, I have a few suggestions for additions. Why a discussions folder class and a discussions class? Can discussions also be added to places elsewhere. A question I also asked at the site: While I think dicussions are nice: what is the difference between discussions and comments? Shouldn't these merge into one 'reaction/feedback/interaction' class (possibly also to include other type of interaction I haven't thought about yet)? Rik From roeder@berg.net Sun Apr 16 23:44:47 2000 From: roeder@berg.net (Maik =?iso-8859-1?Q?R=F6der?=) Date: Mon, 17 Apr 2000 00:44:47 +0200 Subject: [ZDP] Discussion on Threaded Discussion References: <00c101bfa7de$63efc720$fe5da182@etgriend.et.tudelft.nl> Message-ID: <38FA425F.887D0709@berg.net> Hi Rik ! > Why not merge this with Comments, though. > ( in this way it is going to be a bit like Michel Pelletier discussable > for each item in Zope.) The difference is not completely clear to me. For further discussion, please refer to: http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions/discussion/955914808/955921836 > Is it possible to send attachements? > It should be possible to change the ordering of discussions > (like in a mail/news reader) Adding attachements and sorting is planned. To see what else is planned, please refer to: http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions >Remarks: >The posting link should be somewhere else (I had to look for it now). > There should be a reply button at the bottom of each posting. I have added these suggestions into a Task: http://zdp.zope.org/projects/zdptools/tasks/actions_in_context > Is the goal anything squishdot like, or much simpler? If the first, I have a > few suggestions for additions. Simple at first. Then we can talk about feature bloat ;-) > Why a discussions folder class and a discussions class? Can discussions also > be added to places elsewhere. Threaded discussions are separated into DiscussionFolders and Discussions so that you can give different rights to different Roles. DiscussionsFolders are added by Moderators, while Discussions can be added by Visitors. For completeness's sake, we are also planning to perhaps add a DiscussionRoom which only a Manager can add, but this is not decided yet. BTW: I have already put your contextOrderer to good use in many places, and plan to use it more extensively in the future. The great thing is that it could also be used for changing arbitrary properties. For example you can change all properties with id "nickname" for example to enforce a certain naming scheme. I have added this as a Task: http://zdp.zope.org/projects/zdptools/tasks/contextorderer/ Thanks a lot for your comments ! Greetings, Maik From rik.hoekstra@inghist.nl Mon Apr 17 08:58:22 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Mon, 17 Apr 2000 09:58:22 +0200 Subject: [ZDP] Discussion on Threaded Discussion References: <00c101bfa7de$63efc720$fe5da182@etgriend.et.tudelft.nl> <38FA425F.887D0709@berg.net> Message-ID: <38FAC41E.FA039860@inghist.nl> Hi Maik, > > > Why not merge this with Comments, though. > > ( in this way it is going to be a bit like Michel Pelletier discussable > > for each item in Zope.) The difference is not completely clear to me. > > For further discussion, please refer to: > > http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions/discussion/955914808/955921836 OK, I agree with your analysis and your conclusion not to merge them right now. THe only thing I 'worried' about was that the tools would become too dispersed if you have different classes for very similar tasks. > > > Is it possible to send attachements? > > It should be possible to change the ordering of discussions > > (like in a mail/news reader) > > Adding attachements and sorting is planned. > To see what else is planned, please refer to: > > http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions > ok, refer to further remarks there. > >Remarks: > >The posting link should be somewhere else (I had to look for it now). > > There should be a reply button at the bottom of each posting. > > I have added these suggestions into a Task: > > http://zdp.zope.org/projects/zdptools/tasks/actions_in_context agreed > > > Is the goal anything squishdot like, or much simpler? If the first, I have a > > few suggestions for additions. > > Simple at first. Then we can talk about feature bloat ;-) yep, of course. Just for curiosity: any reason why you don't take standard Zope discussion facilities (ZDiscussions etc) as a starting point? > > > Why a discussions folder class and a discussions class? Can discussions also > > be added to places elsewhere. > > Threaded discussions are separated into DiscussionFolders and > Discussions so > that you can give different rights to different Roles. > DiscussionsFolders are added by Moderators, while Discussions can be > added > by Visitors. For completeness's sake, we are also planning to perhaps > add a > DiscussionRoom which only a Manager can add, but this is not decided > yet. Yes, ok, but does this mean that discussion could only take place inside a dicussion folder. Wouldn't it be a good idea to allow moderators also to add a dicussion thread to any item. In this way a discussion is attached to any subject by a moderator, so to say. I realize this is extending functionality, but perhaps later on. It's more an idea than anything else. > > BTW: I have already put your contextOrderer to good use in many places, > and plan to use it more extensively in the future. The great thing > is that it could also be used for changing arbitrary properties. > For example you can change all properties with id "nickname" for > example to enforce a certain naming scheme. I have added this > as a Task: > > http://zdp.zope.org/projects/zdptools/tasks/contextorderer/ > Glad you liked it! Rik From kayeva@hotmail.com Mon Apr 17 12:41:24 2000 From: kayeva@hotmail.com (kamon ayeva) Date: Mon, 17 Apr 2000 11:41:24 GMT Subject: [ZDP] Discussion on Threaded Discussion Message-ID: <20000417114124.38264.qmail@hotmail.com> Extract from discussion between Rik and Maik: > > > Why a discussions folder class and a discussions class? Can discussions >also > > be added to places elsewhere. > >Threaded discussions are separated into DiscussionFolders and >Discussions so >that you can give different rights to different Roles. >DiscussionsFolders are added by Moderators, while Discussions can be >added >by Visitors. For completeness's sake, we are also planning to perhaps >add a >DiscussionRoom which only a Manager can add, but this is not decided >yet. [Rik] Yes, ok, but does this mean that discussion could only take place inside a dicussion folder. Wouldn't it be a good idea to allow moderators also to add a dicussion thread to any item. In this way a discussion is attached to any subject by a moderator, so to say. I realize this is extending functionality, but perhaps later on. It's more an idea than anything else. [Kamon] I agree that a moderator that has a certain right on a specific item should be able to create a discussion on it. Thus a discussion thread will be attached to the object. Hmm, while thinking about this, I found maybe we also need a DiscussionThread class. This is the container object that is added each time a discussion is created in the context of an object anywhere. In the case of centralised discussions, a DiscussionsThread is added to a DiscussionsFolder. In the case of non-centralised discussions, a DiscussionsThread is added by itself attached to the discussed object. What do you think ? --Kamon ______________________________________________________ Get Your Private, Free Email at http://www.hotmail.com From tom.deprez@uz.kuleuven.ac.be Mon Apr 17 13:14:24 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Mon, 17 Apr 2000 14:14:24 +0200 Subject: [ZDP] Re: General Q'ns In-Reply-To: <38FB0C41.414768F@axion-gmbh.de> Message-ID: <3.0.6.32.20000417141424.00928140@poirot> Hi Maik, No prob, glad you found the bug and removed it. 1. What does the 'Add abstract' means? (I've found the q'n in another thread so this is ok now) 2. In the end, what will be the difference between Squishdot and Threaded discussions? 3. Discussions and DiscussionFolder are both the same, ie. they hold postings? They only differ by whom they can be created. Is this assumption correct? Isn't it a little bit too flexible to allow 'anonymous' users to create discussions? Why not allowing them to propose one, but that still a maintainer has to allow it to be made public? This way, you can avoid duplicate discussions. Tom. At 14:06 17/04/2000 +0100, you wrote: >Hi Tom ! > >Terribly sorry, but there was a bug in the ZDP-Tools >that caused the content and the abstract to not be added >correctly to your Discussion. > >I have corrected the bug, so you can ask your questions >again. > >Really sorry for the information loss ! > >Greetings, > >Maik > From mroe@axion-gmbh.de Mon Apr 17 14:30:56 2000 From: mroe@axion-gmbh.de (Maik =?iso-8859-1?Q?R=F6der?=) Date: Mon, 17 Apr 2000 14:30:56 +0100 Subject: [ZDP] Discussion on Threaded Discussion Message-ID: <38FB1210.6306A04E@axion-gmbh.de> Hi ! > Extract from discussion between Rik and Maik: > > > > > Why a discussions folder class and a discussions class? Can discussions > > > also be added to places elsewhere. > > > >Threaded discussions are separated into DiscussionFolders and > >Discussions so that you can give different rights to different Roles. > >DiscussionsFolders are added by Moderators, while Discussions can be > >added by Visitors. For completeness's sake, we are also planning to > >perhaps add a DiscussionRoom which only a Manager can add, but this > >is not decided yet. > > [Rik] Yes, ok, but does this mean that discussion could only take place > inside a dicussion folder. Wouldn't it be a good idea to allow moderators > also to add a dicussion thread to any item. In this way a discussion is > attached to any subject by a moderator, so to say. I realize this is > extending functionality, but perhaps later on. It's more an idea than > anything else. > > [Kamon] I agree that a moderator that has a certain right on a specific item > should be able to create a discussion on it. Thus a discussion thread will > be attached to the object. The Moderator you are talking about here would be the Maintainer of the object. I have changed the implementation plans so that Maintainers can create DiscussionRooms and DiscussionFolders inside objects they are Maintainer of. See: http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions/ > Hmm, while thinking about this, I found maybe we > also need a DiscussionThread class. This is the container object that is > added each time a discussion is created in the context of an object > anywhere. This would be the DiscussionFolder, if one topic is enough. A Maintainer would choose a DiscussionRoom if he has many things to discuss in separate DiscussionFolders. > In the case of centralised discussions, a DiscussionsThread is added to a > DiscussionsFolder. I think we don't need a DiscussionThread when we have DiscussionRooms and DiscussionFolders. > In the case of non-centralised discussions, a DiscussionsThread is added by > itself attached to the discussed object. > What do you think ? Right. This means adding a DiscussionFolder to an object, where the DiscussionFolder starts a thread. Thanks for your feedback ! Best regards, Maik From mroe@axion-gmbh.de Mon Apr 17 15:56:58 2000 From: mroe@axion-gmbh.de (Maik =?iso-8859-1?Q?R=F6der?=) Date: Mon, 17 Apr 2000 15:56:58 +0100 Subject: [ZDP] Re: General Q'ns Message-ID: <38FB263A.80B70EAE@axion-gmbh.de> Hi Tom ! > 1. What does the 'Add abstract' means? (I've found the q'n in another > thread so this is ok now) This is just optional. You can give a little introduction about the content that follows. You will find this in every single ZClass of the ZDP-Tools, but this may change. I have added this to the ZDP-Tools FAQ http://zdp.zope.org/projects/zdptools/faq/general/955978642 > 2. In the end, what will be the difference between Squishdot and > Threaded discussions? I don't know much about Squishdot, but the main difference is that Threaded Discussions are integrated in the ZDP-Tools now. It would be hard to incorporate Squishdot Discussions into the ZDP-Tools, because I guess much of the implementation is written in Python, and the philosophy of the ZDP-Tools is to do it all in ZClasses and DTML for programming through the web. > 3. Discussions and DiscussionFolder are both the same, ie. they hold > postings? They only differ by whom they can be created. Is this > assumption correct? Yes. But there is a small difference between DiscussionFolders and Discussions: DiscussionFolders let the Moderator set the topic of the Discussion, and Discussions are only Postings to this topic by Members. You can find out more about what the Classes are for here: http://zdp.zope.org/projects/zdptools/tasks/threadeddiscussions > Isn't it a little bit too flexible to allow 'anonymous' users to create > discussions? Why not allowing them to propose one, but that still a > maintainer has to allow it to be made public? This way, you can avoid > duplicate discussions. A Discussion is just a Posting to a Topic given in a DiscussionFolder. A Discussion can also be a Posting to another Discussion that is already inside a DiscussionFolder. Right now Anonymous can add Comments to CommentFolders, and in the same way, it should be possible for Anonymous to add Discussions to DiscussionFolders or Discussions. > It would be better to place the 'Edit' links right under the > content itself. For a current discussion on this see: http://zdp.zope.org/projects/zdptools/tasks/actions_in_context/ > This is more natural: ie a person first reads the > content and then perhaps wants to change it. The 'Add abstract' button > is somehow a little bit distracting. I would place it somewhere else, > because I think not much people will use it anyway. I think that we should add a recommendation to the ZDP Style Guide to give a small abstract to every single object you add to the ZDP-Tools. There may be places where this makes no immediate sense, and in such a case, the ZClass should be changed as I have written here: http://zdp.zope.org/projects/zdptools/tasks/actions_in_context/ > A threaded discussion is meant for quickly sharing ideas, not to formulate them very well. > Like it is now, I'm always attracted to add an abstract because the 'add' > link distracts me from the real content. > ... Is it secured? ie. Can everybody change/add an abstract and change a > discussion or can this only be done by the initial creater of the discussion? Added this as a suggestion to: http://zdp.zope.org/projects/zdptools/tasks/actions_in_context/ Greetings, Maik Röder From Amos@digicool.com Mon Apr 17 19:42:59 2000 From: Amos@digicool.com (Amos Latteier) Date: Mon, 17 Apr 2000 14:42:59 -0400 Subject: [ZDP] ANNOUNCE: Zope Tutorial 1.0a3 Message-ID: <613145F79272D211914B0020AFF64019320567@gandalf.digicool.com> > Comments on Amos' Tutorial Material > > First, boy, the URL to access it the tutorial is pretty buried! > Obviously people will do something closer to "click on help, then > click on tutorials", right? Right. The tutorial (and the help system) will ship with the next major version of Zope. It will be easy to get to the tutorial, and no installation or typing in URLs will be necessary. > The tutorial doesn't have much of a cover page, something that > explains how tutorials work, who they are for, etc. Yes, the tutorial needs some explanation of what it is, how it works, and who its for. > Obviously the presentation in HTML is pretty bland, it's just the > default rendering. Is it a goal of the tutorials to have them be > visually engaging, a la XML.com articles? Not really, but it would probably be a good idea. > It's important to let people know how many more lessons there are. Yes, but I imagine that you don't have to do all the lessons if you don't want to. There should be some way to skip around or come back to the tutorial later. > Is there some way to avoid discussion of 'index_html'? Can you just > make it 'home.html'? Since few have ever seen the '_html' style, > they will be presented with a new concept. Though (until we fix > Zope) they'll need to know about 'index_html', that Zen should be > postponed. They should be kept close to what they already know. 'home.html' seems fine. > On '1. Change the...' the line ends with a double colon. Structured > text should have converted that to a single colon for display, > right? It never seems to do that for me :-( > Near the top of Lesson 1, you have 'First you need...' In that line > you have 'DTML Documents' with the 's' in documents as part of the > fixed font. It implies that the 'DTML Documents' is a concept, > rather than 'DTML Document'. Later under Summary you do the right > thing, having _DTML Document_s for a hyperlink. > > Man, this is good. The use of a glossary is just earth shattering. > Is the glossary associated with the help system _globally_ (hope > so!) or just with the tutorials? I'd like to see a central glossary > in the help system. It is not currently a global facility of the help system. It could be, though. > Change the last paragraph to something like: > > Congratulations, you've created a web page with Zope. In the next > step, > > That is, set the scene briefly for the next page. Good idea. > Perhaps it's just me, but the navigation buttons seem oddly placed. > I wonder if they should be left justified. Whatever. > In Lesson 2, the first paragraph has a grammar error. How about: > > Elvis loved his home, Graceland. Let's link an existing > page to our > web site with information about Graceland. Done. > I think the Lesson 2 page should reiterate the explanation of DTML > tags. Good idea. I think in general the tutorial should repeat and complicate ideas that are introduced earlier. > A note at this point. The text is extremely terse, as opposed to an > XML.com article. Does everybody think that this is the right > approach? I do, but more feedback is appreciated. I agree. I think more detail is needed, but elsewhere. The glossay is a start, but How-Tos and the Guides should be the locaion of the real in depth discussion. > I think that 'id' and 'title' should be glossary entries. In the > 'id' entry you can explain the rules for valid characters. In > 'title', you can explain that it is optional, and 'title_or_id' is > the preferred way to access it. OK. -Amos -- Amos Latteier mailto:amos@digicool.com Digital Creations http://www.digicool.com From kayeva@hotmail.com Mon Apr 17 21:11:41 2000 From: kayeva@hotmail.com (kamon ayeva) Date: Mon, 17 Apr 2000 20:11:41 GMT Subject: [ZDP] ANNOUNCE: Zope Tutorial 1.0a3 Message-ID: <20000417201141.5548.qmail@hotmail.com> Hi Amos, I quickly walked through the tutorial. I had a first installation with the previous version and when I installed the latest one over it, the tutorial did not start at the indicated Url. It only worked after I deleted the product and re-installed it. That is just to say that installation was not obvious. So it is a good thing if the next revision does not require any installation from the user. >> A note at this point. The text is extremely terse, as opposed >to an >> XML.com article. Does everybody think that this is the right >> approach? I do, but more feedback is appreciated. > >I agree. I think more detail is needed, but elsewhere. The glossay >is a >start, but How-Tos and the Guides should be the locaion of the real >in >depth discussion. I also think the tutorial content should be more visual. Anyway, it is good for a first version. Good job. Regards, Kamon ______________________________________________________ Get Your Private, Free Email at http://www.hotmail.com From Amos@digicool.com Tue Apr 18 00:12:00 2000 From: Amos@digicool.com (Amos Latteier) Date: Mon, 17 Apr 2000 19:12:00 -0400 Subject: [ZDP] ANNOUNCE: Zope Tutorial 1.0a3 Message-ID: <613145F79272D211914B0020AFF64019320573@gandalf.digicool.com> > But this tutorial is just > one step in > the learning process. It is the practical part of a lesson, > but there is > more to it than just that (according to my professor who is teaching > technical classes in Business environments for 5-7 or more > years). While > showing all these examples, some more theory and design goals > should be > built in, but in a way that the trainee does not even know > that he learned > about it. That is probably the hardest point about teaching. It's hard to balance explanation with demonstration. My general approach with the tutorial is to give lots of demonstration and link to external explanations. > And because of that I disagree with Paul on not explaining > index_html. At > the beginning the student will accept more 'odd' things than > later. In fact > the idea of objects itself should be much more stressed right > in the first > lesson, without scaring the student. You do not have to explain every > consequence of an object (in fact the first lesson would be > the wrong place > for that), but introduce the students to the idea. I think it's fine to refer to Zope objects as 'objects', but I don't want to explain object-oriented design in the tutorial. > Here is my main problem (after looking at the code) that I > have, that may > also address one of Paul's points. The implementation of the > tutorial as a product is questionable. I am not interested in designing the perfect tutorial software ;-) I am interested in finishing a desperately needed piece of documentation and getting it into the hands of folks who desperately need it. > I like the glossary though. But I think it should be much > more complete and > have terms like 'object', 'URL', 'Acquisition' and so on. I > think that > would help. Then for big issues, like 'Acquisition', say > click here for an > advanced lesson on 'Acquisition' (that is just an example). I agree that it needs to be fleshed out. (Patches accepted!) I am mostly adding terms as I encounter them in the lessons. So far acquisition doesn't figure in any lessons. > One big assumption you (Amos) make is that people are > familiar with certain > terms and principles. '"That is a bad assumption.", as my > prof would say. > You have to imagine that you talk to someone who just knows > how to use a > computer well, maybe knows how to install some hardware, but > never touched > any programming language or something alike (such as HTML). You may be right. I should probably enumerate the required subjects at the beginning such as basic knowledge of HTML, URLs, how to use a browser, etc. > I think many people come to Zope, because they heard that > they can create > 'dynamic' (they may not even completely understand what this > term means) > Web pages. We all know that they are not the people who will > end up being > Zope gurus, but they may become pretty sufficient using Zope. > you have to > give these people a very easy entrance or you will loose > them. I agree. Can you give specific advice to make the tutorial easier to these folks? > But what is my point after all this: I think with an > interactive tutorial > like this you have the power to address all three levels of students > easily. At the beginning for example, you can ask what > difficulty level the > tutorial should be in and then serve more or less information > based on their input. This is a reasonable suggestion, however, I am inclined to write only one tutorial, not three. I would rather let folks skip ahead if they find it too easy, than try to second guess exactly what level of hand holding is needed. Perhaps after the tutorial is released and we start to get more feedback from actual users we can work on a customization system. Thanks for the comments! -Amos -- Amos Latteier mailto:amos@digicool.com Digital Creations http://www.digicool.com From tom.deprez@uz.kuleuven.ac.be Thu Apr 20 15:48:29 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Thu, 20 Apr 2000 16:48:29 +0200 Subject: [ZDP] NEw ZDP Look? Message-ID: <3.0.6.32.20000420164829.009586e0@poirot> Hi, I don't know if this is going to be the new look of ZDP, but I kinda like it. Only, we should color some backgrounds (ie the news in light-yellow). In such a way that we get the familiar ZDP colors again. This coloring would also provide a not overwelming look (so much information scares people), like it is now. Perhaps, some links to other old information, ie. members, joining, ... tom. From roeder@berg.net Thu Apr 20 16:09:02 2000 From: roeder@berg.net (Maik Roeder) Date: Thu, 20 Apr 2000 17:09:02 +0200 Subject: [ZDP] NEw ZDP Look? References: <3.0.6.32.20000420164829.009586e0@poirot> Message-ID: <38FF1D8E.E25BA38@berg.net> Hi Tom ! I did have some time before going to a lecture, so I changed the Template a little bit. The speed of our internet access in university is really great ! :-) Bandwidth is everything ! Still, at home I don't have such a fast access ,and loading the ZDP pages with the images takes longer than necessary, so the new management interface is less cluttered. Tom Deprez wrote: > > Hi, > > I don't know if this is going to be the new look of ZDP, but I kinda like > it. It's only for managers right now :-) > Only, we should color some backgrounds (ie the news in light-yellow). > In such a way that we get the familiar ZDP colors again. The philosophy is always: Change no matter what no matter how no matter who :-) Evolution through Mutation. Selection comes later. > This coloring would also provide a not overwelming look (so much > information scares people), like it is now. > Perhaps, some links to other old information, ie. members, joining, ... Sure, has to be done. Greetings, Maik From flahr@ABRIL.COM.BR Thu Apr 20 16:48:34 2000 From: flahr@ABRIL.COM.BR (Fabio Lahr) Date: Thu, 20 Apr 2000 12:48:34 -0300 Subject: [ZDP] Zope running under Mac OSX Message-ID: In order to use Zope I was trying to compile Python under Mac OSX, however I cannot get it to compile under OSX... any suggestions???? Thanks, Fabio Lahr (flahr@abril.com.br) From tom.deprez@uz.kuleuven.ac.be Thu Apr 20 17:00:07 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Thu, 20 Apr 2000 18:00:07 +0200 Subject: [ZDP] NEw ZDP Look? In-Reply-To: <38FF1D8E.E25BA38@berg.net> References: <3.0.6.32.20000420164829.009586e0@poirot> Message-ID: <3.0.6.32.20000420180007.0096e740@poirot> Hi Maik, I understand about the template. It's not bad now, only like I said, we should change some background colors which wil make the page more readable and some top navigation bars would be nice too. Tom. >Hi Tom ! > > >I did have some time before going to a lecture, so I changed the >Template a little bit. >The speed of our internet access in university is really great ! :-) >Bandwidth is everything ! Still, at home I don't have such a fast >access ,and loading the ZDP pages with the images takes longer than >necessary, so the new management interface is less cluttered. > >Tom Deprez wrote: >> >> Hi, >> >> I don't know if this is going to be the new look of ZDP, but I kinda like >> it. > >It's only for managers right now :-) > >> Only, we should color some backgrounds (ie the news in light-yellow). >> In such a way that we get the familiar ZDP colors again. > >The philosophy is always: > >Change no matter what no matter how no matter who :-) >Evolution through Mutation. Selection comes later. > >> This coloring would also provide a not overwelming look (so much >> information scares people), like it is now. >> Perhaps, some links to other old information, ie. members, joining, ... > >Sure, has to be done. > >Greetings, > >Maik > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From srichter@cbu.edu Thu Apr 20 17:32:26 2000 From: srichter@cbu.edu (Stephan Richter) Date: Thu, 20 Apr 2000 11:32:26 -0500 Subject: [ZDP] Zope running under Mac OSX In-Reply-To: Message-ID: <4.3.1.0.20000420112945.00a97ab0@mail.cbu.edu> At 12:48 PM 4/20/00 -0300, you wrote: >In order to use Zope I was trying to compile Python under Mac OSX, however I >cannot get it to compile under OSX... any suggestions???? What did not compile? Can I see the error output? (I do not use Mac OSX, but I compile stuff pretty frequently.) BTW, questions, like this should be posted under zope@zope.org or even better the Python mailing lists (unfortunately I don't know the E-mail address). Regards, Stephan -- Stephan Richter - (901) 573-3308 - srichter@cbu.edu CBU - Physics & Chemistry; Framework Web - Web Design & Development PGP Key: 735E C61E 5C64 F430 4F9C 798E DCA2 07E3 E42B 5391 From roeder@berg.net Thu Apr 20 18:42:07 2000 From: roeder@berg.net (Maik Roeder) Date: Thu, 20 Apr 2000 19:42:07 +0200 Subject: [ZDP] How-tos mirror links References: <20000420172922.40144.qmail@hotmail.com> Message-ID: <38FF416F.2DA973E8@berg.net> Hi Kamon ! kamon ayeva wrote: > > Maik, > > I started looking at this and adapting it for the how-tos. > I don't understand how you actually use the tips_in_xml script. > Have you got a how-to so I can understand this technique ? Put the script into a DTML Method on your Zope.org account. Call it. Save the XML file, upload the file to ZDP via ZClient (or some other method) :-) Have a look at the Howto ZClass on Zope.org by creating one and having a look at the properties, or by looking at an existing one and viewing the source. Or have a look at how the search is implemented on Zope.org by looking at the source code. Greetings, Maik From jeffrey@Digicool.com Thu Apr 20 19:00:47 2000 From: jeffrey@Digicool.com (Jeffrey P Shell) Date: Thu, 20 Apr 2000 14:00:47 -0400 Subject: [ZDP] Compiling Python on MacOS X Message-ID: > In order to use Zope I was trying to compile Python under Mac OSX, however I > cannot get it to compile under OSX... any suggestions???? > Thanks, > Fabio Lahr (flahr@abril.com.br) I assume that you're talking about one of the developer releases of MacOS X and not a shipping release of MacOS X Server. This basically goes for either platform: o Due to the case insensitive (but preserving) nature of the HFS+ File System, Python will not compile on that due to the python source code having a top level directory named 'Python' and the make/build process wanting to move the executable, 'python' to the top directory at the end of the build process. It's pretty hard to get around this due to future things you have to do after the main build process (ie, 'make install'). MacOS X, starting with Developer Preview 2, allowed you to install MacOS X on an HFS+ partition. This is great if you're intending to use it a lot with MacOS 8/9 (either in the Classic environment or wanting to access that volume under MacOS 8/9), but if you're going to be using more Unix-oriented tools, install on a UFS partition. MacOS X Server can only install on a UFS partition, but you could still run into this problem if you tried to build Python on an HFS+ one. If that's not your problem, I suggest checking out my mediocre-ly put together HowTo on building Zope on MacOS X / MacOS X Server. It should apply to all Darwin based platforms. I'm no Unix or Mach / Darwin expert, this is just the best approach I've been able to find. http://www.zope.org/Members/jshell/buildingZopeOnMacOSXServer -- Jeffrey P Shell, jeffrey@Digicool.com http://www.zope.org/ From rik.hoekstra@inghist.nl Thu Apr 20 20:41:30 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Thu, 20 Apr 2000 21:41:30 +0200 Subject: [ZDP] NEw ZDP Look? Message-ID: <009401bfab00$6ef28340$fe5da182@etgriend.et.tudelft.nl> >Hi Tom ! > > >I did have some time before going to a lecture, so I changed the >Template a little bit. >The speed of our internet access in university is really great ! :-) >Bandwidth is everything ! Still, at home I don't have such a fast >access ,and loading the ZDP pages with the images takes longer than >necessary, so the new management interface is less cluttered. I like it. > >Tom Deprez wrote: >> >> Hi, >> >> I don't know if this is going to be the new look of ZDP, but I kinda like >> it. > >It's only for managers right now :-) > Hm, perhaps it's not a bad idea to keep the schism in the public view and the managers view. The public view should be cleaned up a bit I think, but I like that one as well (having a different purpose). >> Only, we should color some backgrounds (ie the news in light-yellow). >> In such a way that we get the familiar ZDP colors again. > >The philosophy is always: > >Change no matter what no matter how no matter who :-) >Evolution through Mutation. Selection comes later. > Evolution is through random mutation, I thought your actions were a bit more coordinated from the start ;-) ? Rik From roeder@berg.net Thu Apr 20 22:57:58 2000 From: roeder@berg.net (Maik Roeder) Date: Thu, 20 Apr 2000 23:57:58 +0200 Subject: [ZDP] NEw ZDP Look? References: <009401bfab00$6ef28340$fe5da182@etgriend.et.tudelft.nl> Message-ID: <38FF7D66.1F7ACADB@berg.net> Hi Rik ! Rik Hoekstra wrote: > >It's only for managers right now :-) > > > > Hm, perhaps it's not a bad idea to keep the schism in the public view and > the managers view. The public view should be cleaned up a bit I think, but I > like that one as well (having a different purpose). I will clean things up soon. > >The philosophy is always: > > > >Change no matter what no matter how no matter who :-) > >Evolution through Mutation. Selection comes later. > > > > Evolution is through random mutation, I thought your actions were a bit more > coordinated from the start ;-) ? No way ! I am a follower of "The Mud-Throwing Theory of Usability": The trick is to "design new websites and innovative Internet services with the idea to throw it at the wall and see if it sticks. The metaphor of treating design like mud supposedly leads to shorter time-to-market and thus faster success in growing the business. The assumption is that speed is everything. If the initial design has weaknesses (i.e., drops off the wall), then they can always be fixed in the redesign." This kinda sums it up, what I've done with the ZDP-Tools ;-) If you want to read more here is the link: http://www.useit.com/alertbox/20000402.html Greetings, Maik Röder From tom.deprez@uz.kuleuven.ac.be Fri Apr 21 09:46:30 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Fri, 21 Apr 2000 10:46:30 +0200 Subject: [ZDP] ZWiki Message-ID: <3.0.6.32.20000421104630.00963ad0@poirot> Hi, Can somebody give me the light on the ZWiki websites? I don't understand them. What do they, what make them so important? I think I've read all the links which send me to ZWiki, but still I don't see why they are so important. I see DC asking for visiting a ZWiki page (on API?) and elaborate... but sorry I don't see it, it looks spaghetti to me, certainly with the strange names given to a ZWiki page (no offense). Perhaps, some little more explenation would give me the light. Or perhaps a clearer organisation (with easy to understand title-links) would improve an overall ZWike page. Can somebody shine a light? Thanks Tom. From tom.deprez@uz.kuleuven.ac.be Fri Apr 21 11:55:20 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Fri, 21 Apr 2000 12:55:20 +0200 Subject: [ZDP] ZFAQ Message-ID: <3.0.6.32.20000421125520.00922260@poirot> Hi, When working on my ZClasses I just came up to a nice idea with FAQ. At the moment we show first the questions. This was already a nice improvement. But what about showing it in a tree way? eg. All questions are shown: Clicking on a question (thus on a branch) will reveal it's aswer right below it. Clicking again on a question (or on another) will close the answer (and reveal the answer to the other question) What do you think? Tom. From tom.deprez@uz.kuleuven.ac.be Fri Apr 21 12:49:09 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Fri, 21 Apr 2000 13:49:09 +0200 Subject: [ZDP] Zope France Down? Message-ID: <3.0.6.32.20000421134909.00944ec0@poirot> Is the france zope list site down? Does it exists anymore? http://www.zope-france.org:8080/sujets/Documentation/zbook Tom. From roeder@berg.net Fri Apr 21 12:45:50 2000 From: roeder@berg.net (Maik Roeder) Date: Fri, 21 Apr 2000 13:45:50 +0200 Subject: [ZDP] ZWiki References: <3.0.6.32.20000421104630.00963ad0@poirot> Message-ID: <39003F6E.65B76C1E@berg.net> Hi Tom ! Tom Deprez wrote: > Can somebody give me the light on the ZWiki websites? > > I don't understand them. What do they, what make them so important? > I think I've read all the links which send me to ZWiki, but still I don't > see why they are so important. > I see DC asking for visiting a ZWiki page (on API?) and elaborate... but > sorry I don't see it, it looks spaghetti to me, certainly with the strange > names given to a ZWiki page (no offense). > Perhaps, some little more explenation would give me the light. Or perhaps a > clearer organisation (with easy to understand title-links) would improve an > overall ZWike page. > > Can somebody shine a light? Thanks Disclaimer: I am no ZWiki expert, but I'll try to summarize what I think I have understood. The point of ZWiki is that all the spaghetti can be thrown away by _you_ and replaced with something better without asking anybody, as long as the result is something much greater :-) ZWiki is about ad hoc collaboration to quickly involve other people by giving them the right to improve anything anywhere. This philosophy is just like the ZDP-Tools philosophy, with the difference that the ZDP-Tools enforce a hierarchy on the stuff, while (from what I know) in ZWiki people organize the content in a way that best suits their needs. Greetings, Maik From roeder@berg.net Fri Apr 21 12:46:00 2000 From: roeder@berg.net (Maik Roeder) Date: Fri, 21 Apr 2000 13:46:00 +0200 Subject: [ZDP] ZFAQ References: <3.0.6.32.20000421125520.00922260@poirot> Message-ID: <39003F77.A7D68244@berg.net> Hi Tom ! Tom Deprez wrote: > When working on my ZClasses I just came up to a nice idea with FAQ. > At the moment we show first the questions. This was already a nice > improvement. We also show the questions together with the answers below the questions, so that you can click on the question in the list and directly get to the answer below it's question. > But what about showing it in a tree way? This way we lose some usability because people won't be able to quickly jump from a question to an answer on one page and back again without reloading the page. A tree would mean to reload the tree for every question or answer. To print the tree you would first load the page again in expanded mode, and then click on "Show printable", while right now you already have all the questions and answers on one page and can directly click on "Show printable" > eg. > > All questions are shown: > > Clicking on a question (thus on a branch) will reveal it's aswer right > below it. > Clicking again on a question (or on another) will close the answer (and > reveal the answer to the other question) This means loading many many pages, while right now we have all on one page without needing to reload. > What do you think? To enhance the usability of the FAQ it would be best to have a limit on the number of questions in one category. We should split some categories with many questions. Greetings, Maik From tom.deprez@uz.kuleuven.ac.be Fri Apr 21 14:10:32 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Fri, 21 Apr 2000 15:10:32 +0200 Subject: [ZDP] ZFAQ In-Reply-To: <39003F77.A7D68244@berg.net> References: <3.0.6.32.20000421125520.00922260@poirot> Message-ID: <3.0.6.32.20000421151032.009589e0@poirot> Ha, yes, you're correct, this would mean a lot of reloading the page. Tom. At 13:46 21/04/2000 +0200, Maik Roeder wrote: >Hi Tom ! > >Tom Deprez wrote: >> When working on my ZClasses I just came up to a nice idea with FAQ. >> At the moment we show first the questions. This was already a nice >> improvement. > >We also show the questions together with the answers below the questions, >so that you can click on the question in the list and directly get >to the answer below it's question. > >> But what about showing it in a tree way? > >This way we lose some usability because people won't be able to quickly >jump from a question to an answer on one page and back again without >reloading the page. A tree would mean to reload the tree for every >question or answer. To print the tree you would first load the page >again in expanded mode, and then click on "Show printable", while right >now you already have all the questions and answers on one page and can >directly click on "Show printable" > >> eg. >> >> All questions are shown: >> >> Clicking on a question (thus on a branch) will reveal it's aswer right >> below it. >> Clicking again on a question (or on another) will close the answer (and >> reveal the answer to the other question) > >This means loading many many pages, while right now we have all on >one page without needing to reload. > >> What do you think? > >To enhance the usability of the FAQ it would be best to have a limit >on the number of questions in one category. We should split some >categories with many questions. > >Greetings, > >Maik > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From grizel@xlogx.com Fri Apr 21 15:20:15 2000 From: grizel@xlogx.com (Pierre-Julien Grizel) Date: Fri, 21 Apr 2000 16:20:15 +0200 Subject: [ZDP] Re: [Zope] Zope France Down? References: <3.0.6.32.20000421134909.00944ec0@poirot> Message-ID: <3900639F.8F67C426@xlogx.com> The whole site seems to be down for me too..... Regards, P.-J. Tom Deprez wrote: > > Is the france zope list site down? Does it exists anymore? > > http://www.zope-france.org:8080/sujets/Documentation/zbook > > Tom. > > _______________________________________________ > Zope maillist - Zope@zope.org > http://lists.zope.org/mailman/listinfo/zope > ** No cross posts or HTML encoding! ** > (Related lists - > http://lists.zope.org/mailman/listinfo/zope-announce > http://lists.zope.org/mailman/listinfo/zope-dev ) From kayeva@hotmail.com Fri Apr 21 16:37:48 2000 From: kayeva@hotmail.com (kamon ayeva) Date: Fri, 21 Apr 2000 15:37:48 GMT Subject: [ZDP] ZWiki Message-ID: <20000421153748.85828.qmail@hotmail.com> Hi Tom, In addition to Maik's explanation, I was having the same problems in finding my way in the ZWiki universe untill I found this link: http://www.zope.org/WikiCentral/FrontPage Btw, maybe there needs a ZWiki category in ZFAQ. Regards, Kamon >From: Maik Roeder >To: zdp@zope.org >Subject: Re: [ZDP] ZWiki >Date: Fri, 21 Apr 2000 13:45:50 +0200 > >Hi Tom ! > >Tom Deprez wrote: > > Can somebody give me the light on the ZWiki websites? > > > > I don't understand them. What do they, what make them so important? > > I think I've read all the links which send me to ZWiki, but still I >don't > > see why they are so important. > > I see DC asking for visiting a ZWiki page (on API?) and elaborate... but > > sorry I don't see it, it looks spaghetti to me, certainly with the >strange > > names given to a ZWiki page (no offense). > > Perhaps, some little more explenation would give me the light. Or >perhaps a > > clearer organisation (with easy to understand title-links) would improve >an > > overall ZWike page. > > > > Can somebody shine a light? Thanks > >Disclaimer: I am no ZWiki expert, but I'll try to summarize >what I think I have understood. > >The point of ZWiki is that all the spaghetti can be thrown away by _you_ >and replaced with something better without asking anybody, as long as >the result is something much greater :-) ZWiki is about ad hoc >collaboration >to quickly involve other people by giving them the right to improve >anything anywhere. This philosophy is just like the ZDP-Tools philosophy, >with the difference that the ZDP-Tools enforce a hierarchy on the >stuff, while (from what I know) in ZWiki people organize the content >in a way that best suits their needs. > >Greetings, > >Maik > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > ________________________________________________________________________ Get Your Private, Free E-mail from MSN Hotmail at http://www.hotmail.com From msimcich@accesstools.com Fri Apr 21 17:19:59 2000 From: msimcich@accesstools.com (Michael Simcich) Date: Fri, 21 Apr 2000 09:19:59 -0700 Subject: [ZDP] RE: [Zope] ZWiki In-Reply-To: <3.0.6.32.20000421104630.00963ad0@poirot> Message-ID: <001101bfabad$7108b070$0100a8c0@pinol1.sfba.home.com> ZWikis, and Wikis in general, are definitely different . As you probably know, the original Wiki is at http://c2.com/cgi/wiki?WikiWikiWeb. It's the largest Wiki (AFAIK) and of course contains a great number of ruminations about the Wiki way of doing things. What's neat about Wikis, to me at least, is that they offer us a communal scratch-pad which is dead simple to work with. It's really trippy to be able to contribute spontaneously to a website, and to intermingle your own thoughts with those of others. The fact that one is also able to remove whatever you want is even more boundary bending. That wiki sites don't typically end up totally trashed is quite encouraging (sometimes things do happen though - WikiMindWipes etc). In a way I'm sure you could see it as an interesting social experiment. The weird naming is there so that link and new page creation is transparent. After a while I found I became quite fond of the style; there's plenty of humor in the Wiki scene and page names ofen reflect this. It does have limitations that bug me sometimes. Nevertheless I think it's a great invention, and one that will probably spawn variants that are just as interesting. Could happen here in fact! ZWiki is utterly simple to set up, thanks to Simon and DC, and eminently tweakable. Michael Simcich AccessTools -----Original Message----- From: zope-admin@zope.org [mailto:zope-admin@zope.org]On Behalf Of Tom Deprez Sent: Friday, April 21, 2000 1:47 AM To: zdp@zope.org; zope@zope.org Subject: [Zope] ZWiki Hi, Can somebody give me the light on the ZWiki websites? I don't understand them. What do they, what make them so important? I think I've read all the links which send me to ZWiki, but still I don't see why they are so important. I see DC asking for visiting a ZWiki page (on API?) and elaborate... but sorry I don't see it, it looks spaghetti to me, certainly with the strange names given to a ZWiki page (no offense). Perhaps, some little more explenation would give me the light. Or perhaps a clearer organisation (with easy to understand title-links) would improve an overall ZWike page. Can somebody shine a light? Thanks Tom. _______________________________________________ Zope maillist - Zope@zope.org http://lists.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://lists.zope.org/mailman/listinfo/zope-announce http://lists.zope.org/mailman/listinfo/zope-dev ) From zope@teleo.net Fri Apr 21 18:00:27 2000 From: zope@teleo.net (Patrick Phalen) Date: Fri, 21 Apr 2000 10:00:27 -0700 Subject: [ZDP] Wiki Parser? (Was RE: [Zope] ZWiki) In-Reply-To: <001101bfabad$7108b070$0100a8c0@pinol1.sfba.home.com> References: <001101bfabad$7108b070$0100a8c0@pinol1.sfba.home.com> Message-ID: <00042112424502.02973@quadra.teleo.net> [Michael Simcich, on Fri, 21 Apr 2000] :: What's neat about Wikis, to me at least, is that they offer us a communal :: scratch-pad which is dead simple to work with. It's really trippy to be able :: to contribute spontaneously to a website, and to intermingle your own :: thoughts with those of others. :: It does have limitations that bug me sometimes. Nevertheless I think it's a :: great invention, and one that will probably spawn variants that are just as :: interesting. Could happen here in fact! ZWiki is utterly simple to set up, :: thanks to Simon and DC, and eminently tweakable. [I don't know if it's appropriate to continue the crossposting that began this thread. Maybe continued discussion should be moved to zdp?] Anyway, Michael speaks about tweaking or forming variants of ZWiki, which is akin to something I've been thinking about the past few days. There is a common need among open source and open standards communities (including Zope) to evolve discussions from loose and unstructured to something finally more formalized and ordered (e.g., specifications, documentation, etc.). The difference with the Zope community is that we actually have tools which could be adapted to that purpose. Wikis provide one model for the loose first stage (Usenet and threaded mailing list archives provide another). In a way, they overlay a brainstorming model onto the network model. They permit fleeting thoughts to be "captured in a bottle." The problem is how then to migrate from the loose to the structured, once the discussion has run its course and it's time to organize the material and publish something formal (documentation, for example). Of course this can be accomplished by someone laboriously combing through the Wiki or the archive and hand-assembling something, but it would be nice to have tools or hooks to automate the process. Generators have been used in past to create FAQs from discussion lists, but they tend to require a lot of human intervention and they still end up being too linear. Cognitively, homo sapiens aren't equipped with much bandwidth for complexity; they rely on media to aid them. Wikis eventually evolve into complex representations of information with no abstract or overview representation. What Wikis do well is capturing freeform, brainstorming-style discussion. Thereafter, it would be beneficial to have different representations of the information they contain, perhaps including a tree or outline view. How else can you see the whole picture and organize it into something more useful? The Interfaces Wiki is an example. I imagine Michel Pelletier would be happy, when the time comes to turn the ideas in the Interfaces Wiki into real documentation, to be able to see the whole Wiki in a linear or hierarchical view. I don't know how ZWiki is implemented, but if it were XML at a granular level, then maybe it could be parsable into different presentation formats. Or maybe there is some other tool available which already addresses this. E.g., there is wonderful application program called "Inspiration" (Win/Mac) which allows a user to bring up a graphical view and add boxes containing concepts (text and/or images), and then freely interconnect the boxes arbitrarily with lines to form a "concept map." Then, one mouse click can turn that into a collapsible/expandable outline view. Bottom line: is there a way to parse a Wiki and generate an outline view? From slick@bored.com Mon Apr 24 14:59:47 2000 From: slick@bored.com (Gus Mansilla) Date: 24 Apr 2000 13:59:47 -0000 Subject: [ZDP] Please Help Message-ID: <20000424135947.21678.qmail@musone.chek.com> I am a senior at Yorktown Highschool and am currently taking computer Science. Some of you might know my teacher and most likely have been contacted by us. I am trying to learn dtml however i am having extreme difficulty implementing and learning how to use dtml. Though the site on dtml is imformative, i have no idea where to start. I would love to help make the documentations alot more helpful, and would like to volunteer. however, i do need help learning dtml first. If anyone could help me or give me information on volounteering please respond asap. i only have a month left of school and i have very little resources at home. thank you so much for all the work all of you have done with zope and dtml. thanks Gus Mansilla _________________________________________________________________ Signup for you FREE Bored.Com email account at http://www.bored.com From roeder@berg.net Mon Apr 24 14:12:17 2000 From: roeder@berg.net (Maik Roeder) Date: Mon, 24 Apr 2000 15:12:17 +0200 Subject: [ZDP] Please Help References: <20000424135947.21678.qmail@musone.chek.com> Message-ID: <39044831.D03E3CBB@berg.net> Hi Gus ! Gus Mansilla wrote: > > I am trying to learn dtml however i am having extreme difficulty implementing > and learning how to use dtml. Though the site on dtml is imformative, i have no > idea where to start. I would love to help make the documentations alot more > helpful, and would like to volunteer. It would be nice if you could ask some Questions in the FAQ. http://zdp.zope.org/projects/zfaq/ > however, i do need help learning dtml first. If anyone could help me > or give me information on volounteering please respond asap. If you want to become a ZDP member, tell me and I will give you an account. > i only have a month left of school and i have very little resources at home. > thank you so much for all the work all of you have done with zope and dtml. thanks Make sure you have read the Z Document Template Markup Language Reference "The DTML Reference explains how to access and control web objects from within Documents using DTML tags. It includes a fairly exhaustive discussion of such topics as batch insertion, the tree tag, request variables, etc." http://www.zope.org/Documentation/Guides/DTML Greetings, Maik Röder From srichter@cbu.edu Mon Apr 24 17:12:19 2000 From: srichter@cbu.edu (Stephan Richter) Date: Mon, 24 Apr 2000 11:12:19 -0500 Subject: [ZDP] Please Help In-Reply-To: <20000424135947.21678.qmail@musone.chek.com> Message-ID: <4.3.1.0.20000424111007.00a88b60@mail.cbu.edu> At 01:59 PM 4/24/00 +0000, you wrote: >I am a senior at Yorktown Highschool and am currently taking computer >Science. Some of you might know my teacher and most likely have been >contacted by us. > >I am trying to learn dtml however i am having extreme difficulty >implementing and learning how to use dtml. Though the site on dtml is >imformative, i have no idea where to start. I would love to help make the >documentations alot more helpful, and would like to volunteer. however, i >do need help learning dtml first. If anyone could help me or give me >information on volounteering please respond asap. i only have a month left >of school and i have very little resources at home. > >thank you so much for all the work all of you have done with zope and >dtml. thanks > >Gus Mansilla Amos' new Tutorial is pretty nice to start as well. I also would strongly suggest to you to learn Python. The Python documentation is awesome, and if you know already a computer language then you can learn Python in a couple of nights. No really, it is true! I would also like to hear what you would like to see in the DTML documentation. Regards, Stephan -- Stephan Richter - (901) 573-3308 - srichter@cbu.edu CBU - Physics & Chemistry; Framework Web - Web Design & Development PGP Key: 735E C61E 5C64 F430 4F9C 798E DCA2 07E3 E42B 5391 From klm@digicool.com Mon Apr 24 19:06:23 2000 From: klm@digicool.com (Ken Manheimer) Date: Mon, 24 Apr 2000 14:06:23 -0400 (EDT) Subject: [ZDP] Wiki Parser? (Was RE: [Zope] ZWiki) Message-ID: <14596.36127.222849.686472@korak.digicool.com> A digital creations team i'm on has been using a zwiki intensively on a consulting project to collect our requirements/use cases, technical research, project schedules, and so forth. As our wiki grew we encountered some serious problems managing the information in it - keeping it approachable and discoverable for us as well as for our clients. I wound up implementing a kind of outline organization which seems to have made a real and positive impact. What i did was implement a notion of parent and child in the wiki. - Any of pages with wiki references to some wiki page X - X's backlinks - can be designated as parents of X. The backlinks page offers checkboxes for selecting and deselecting page parents. - When a new page is created in the wiki way, by following a new wiki reference from an existing page - the existing page is the first parent of that new page. - The title box for every page shows the "ancestry" for the page - the parents, and their parent, back to one fo the root pages in the wiki (often the FrontPage, though it need not be). - The backlinks page also shows a more complete "ancestry", showing the siblings of the parents and the current page, as well as the parents, themselves. - There is a link above the title bar to show a "table of contents" for the wiki (showing isolated pages that have no children or parents, as well as the hierarchies from the roots) - And another link to show a complete map of the offspring of the current page. (All the outline maps elide repeated entries for any page by substiting a "..." for any repeats. This reduces redundancy and also, crucially, avoids any problems with recursion on containment loops.) This yields a kind of region-oriented nesting - local regions contained within more global regions, and so on. What this produces is something like an extension of classic document structuring, suitable for a table of contents - with the addition that the nesting isn't limited by a small set of document entities (book/chapter/ section/paragraph, or whatever), subparts can exist in multiple places, where appropriate, the structure can be assessed from any location, and so forth. This has helped greatly with our use of the wiki. Not only are our clients now finding their way and even making changes and *adding pages*, new people on the project have found it useful for getting filled in on the project - whereas, before the enhancements, we couldn't even get our clients to find their way in, and even we were often having difficulties navigating and avoiding accumulation of kruft. It still takes discipline on the part of the content authors to deal with accumulated kruft, and to keep the organization sensible. (We still to accumulate some kruft - but much less, and much less due to findability problems.) The wiki doesn't become intelligent - but the authors can adjust the structure intelligently, and make it much easier for visitors (including themselves!) to get oriented and maneuver in the wiki. Patrick phalen wrote: > Or maybe there is some other tool available which already addresses > this. E.g., there is wonderful application program called "Inspiration" > (Win/Mac) which allows a user to bring up a graphical view and add boxes > containing concepts (text and/or images), and then freely interconnect > the boxes arbitrarily with lines to form a "concept map." Then, one > mouse click can turn that into a collapsible/expandable outline view. Interestingly, the upshot of my nesting changes yields a similar structure. It would be nice to employ the tree tag to do exposure control, and how cool it would be to have a graphical editor to manage the various kinds of links. But just having the structure, with some decent presentation and control, is proving invaluable. And it's all in zope, which makes it quite useful for/with many things. I'd like to see these changes propagated, but unfortunately we're all in a crunch, and there's not a lot of time to (1) iron out exactly how general we want to make the changes (simon is considering what a general framework for doing this kind of thing would be), and (2) none of us have had the time to package up the changes nicely. We may see this kind of thing more generally available sometime soon, though... Ken Manheimer klm@digicool.com From Amos@digicool.com Tue Apr 25 03:16:40 2000 From: Amos@digicool.com (Amos Latteier) Date: Mon, 24 Apr 2000 22:16:40 -0400 Subject: [ZDP] ANNOUNCE: Zope Tutorial Preview Message-ID: <613145F79272D211914B0020AFF640193205AD@gandalf.digicool.com> Hello, I'm happy to announce the first public preview of the Zope Tutorial http://www.zope.org/Documentation/Projects/Tutorial The Zope Tutorial is a project to create better documentation for new Zope users. It teaches Zope in a hands-on fashion. This release of the tutorial also includes a preview of the forthcoming online help system and the API documentation facilities. The Zope Tutorial will ship with the next major version of Zope, so you won't have to download it and install it. Please send me your comments, nits, and suggestions. If you are interested in being a famous hero sign up to author a lesson. There's lots of material that isn't covered yet. -Amos -- Amos Latteier mailto:amos@digicool.com Digital Creations http://www.digicool.com From roeder@berg.net Thu Apr 27 01:10:10 2000 From: roeder@berg.net (Maik Roeder) Date: Thu, 27 Apr 2000 02:10:10 +0200 Subject: [ZDP] Zope Documentation Project Status and Plans References: <613145F79272D211914B0020AFF640192634AB@gandalf.digicool.com> <3906FB00.3C086085@texoma.net> <3906FEAB.44EF7503@nipltd.com> <39072508.41321C88@texoma.net> Message-ID: <39078562.9CD6961F@berg.net> Hi ! Jimmie Houchin wrote: > However, what I was somewhat specifically refering to was the official > Zope docs, the guides, et al. I don't know of the availability of those > docs via cvs. There was mention of such possibility at one point, but > haven't seen it since. Quoting the Zope Documentation plan at: http://www.zope.org/Members/Amos/Documentation/Plan "Overhaul Zope Guides & References The current Guides and References need to be updated to keep pace with Zope development. They also need to be opened up so that community members and everyone at DC can contribute to them. To this end we are transitioning away from Framemaker towards DocBook XML. We will make documentation available via CVS and provide write access to selected community members. This will make it easier for folks to make changes and additions to Zope's core documentation. We will provide examples to show how to author Guide and Reference material, and we will maintain scripts to build output in a variety of formats. [...] Project Contact: amos@digicool.com" > I haven't yet gotten around to looking at the ZDP docs much yet. I think > it would be nice if there were more of a central repository of Zope > docs. Docs, how-tos, etc. are currently pretty scattered. The search > facility on the Zope site at least the last time I looked didn't allow > much access to the metadata of the documents. On the ZDP list I had a > brief discussion with Alex Ratti (sp?) about this concerning the > organization of his 'all how-tos' pdf. We plan to solve this problem by linking to Zope.org documents from ZDP. The links will be enriched with meta-information so even though not all documentation is available in one place, there can be one place from where all documentation can be reached. Kamon Ayeva is working on this. > Right now it is difficult to put your hands on all of the material on > any given subject. Being able to mine the knowledge of others better and > easier would make the attainment of ZZen much easier. If that can be > said. :) We are also planning to make Zope documentation available under certain subjects and topics, so people can get right to the information they need, and get an overview of what exists and what is missing. David Kankiewicz has postponed his efforts because of ZCatalog bugs on our ZDP Zope server. To get aware of what is going on in the ZDP-project, we have a list of all documents that have been added in the last 7 days on the start page. This list should be easy to track to see whether something interesting has been added. To further enhance the awareness, I will be developing Changes History and Contributor History ZClasses to track documentation and programming efforts. Further plans concern a new Portal ZClass to give different users a different view on the Information Space, which makes most sense with the Subject/Topic enhancements. In addition, I consider making the Zope Source code searchable on the ZDP site. Another task is to provide a way to rate content so people can get right to the good stuff. Rik Hoekstra has contributed a Context Orderer, which allows to sort all documents in a folder in one form, and which will be extended to edit arbitrary properties of all documents in a folder. We have started using TaskFolders and Tasks to organize the Development of the ZDP-Tools, and I have a first version of a Threaded Discussion Forum working as a first result. As you can see the ZDP is devoted to the mission of providing Zope documentation and giving new views on existing Zope documentation. The ZDP-Tools are developed on-site, and this is the one official version. This makes it very easy for people to enhance the ZDP-Tools, because development takes place concurrently and in a running system. I invite everyone to help the ZDP site better serve the needs of the Zope community. Please send your comments to zdp@zope.org. Best regards, Maik Röder -- Open Source is "about being able to work together with people you've never met, on projects that are in a constant state of flux, on a time schedule that would cause a hummingbird's head to spin." Paul Ferris, http://www.linuxplanet.com/linuxplanet/opinions/1593/1/ From roeder@berg.net Fri Apr 28 09:49:27 2000 From: roeder@berg.net (Maik Roeder) Date: Fri, 28 Apr 2000 10:49:27 +0200 Subject: [ZDP] Zope Documentation Portal Message-ID: <39095097.8058FBF3@berg.net> Hi everyone ! I suggest changing the Zope Documentation Project to a Zope Documentation Portal. This Portal would integrate a view on the existing ZDP content and Zope.org content by creating links to Zope.org documents and enrich these links with meta-information. So even though not all documentation is stored in one place, there can be one place from where all documentation can be reached conveniently. To make Zope documentation available under certain subjects and topics for different users, a new Portal ZClass is needed that provides different views on the Information Space. The following is a suggestion for implementation of the new Subject/Topic Hierarchy. David Kankiewicz has already worked on this problem, and also implemented part of it on the ZDP site. Nevertheless, I want to throw in my thoughts on this, which came up as I tried to understand Davids code ;-) The PTK project also works on this problem, so I have CC'd this mail also to this list to exchange some ideas. In the long term the ZDP-project needs to adopt the PTK, and so discussing this early on could be beneficial. Create three new ZClasses: * TopicFolder (derived from DocumentFolder) nickname: Subject In the root folder, there should be multiple TopicFolders for each Subject. Subjects can be for example "DTML" and "Web Server". Anyone can create TopicFolders, but unless they are approved, it is not going to be publicly visible. * Topic (derived from Search) nickname: Topic Under the TopicFolders, which define the Subjects, there should be multiple Topics. Topics will find their contents through a ZCatalog Search and so it makes sense to derive it from the Search ZClass which already exists in the ZDP-Tools. As with TopicFolders, they can be created by anyone, but must be approved to get visible. * Portal (derived from DocumentFolder) nickname: Recipient Portals filter the TopicFolders and Topics for interest groups, defined by the Recipient nickname. A Portal can show the TopicFolders with their abstract or show the TopicFolders with their Topics as links in a Yahoo style. Portals are only added by Managers with one exception. Portals may also be used to create a Personalized view on the information space for members. Members may want to put their own Portal(s) into their MemberClass. The Recipient variable would in this case just be user defined, and default to the member login name. When the Subject/Topic hierarchy is built, then it can be displayed very fast inside a Portal without using ZCatalog. The ZCatalog search starts inside the Topics for the first time. When a Topic is displayed, a Search is performed with the following parameters: * Subject = TopicFolder.nickname * Topic = Topic.nickname * Recipient = Portal.nickname This should keep the number of results rather small. We are already deep in a context and filter on the Recipient. This could be further reduced by introducing new filters like for example "zen_level". So, as a consequence we have to give every ZClass the following properties so we can search on them in the document hierarchy using ZCatalog: DocumentFolder Subject Topic Recipient Now, let's see how document creation would look like. When we create a document, we are always somewhere in the document hierarchy, and can always assume that we are in the context of a subject and a topic. This can be solved by making the following subject and topic default: Root (/ of zdp.zope.org): subject: Zope topic: ZDP Let's look at an example of how the subject/topic hierarchy is interwoven in the document hierarchy: * Root (nickname: ZDP: Zope Documentation Project) subject: Zope topic: ZDP * Project Folder (nickname: Projects) subject: ZDP topic: ZDP projects * Project (nickname: ZDP-Tools) subject: ZDP projects topic: ZDP-Tools project * ProductDocumentation (nickname: Documentation) subject: ZDP-Tools project topic: ZDP-Tools Documentation Please notice that the subjects are always the topics of the parent folder. To see where we take the subjects and topics from when adding a new document to the document hierarchy, we have a look at an example: Let's suppose we want to add a new Project called ZBook to the document hierarchy under the Project Folder: * ProjectFolder (nickname Projects) subject: ZDP topic: ZDP projects * Project (nickname: ZBook) subject: ZDP projects topic: ZBook project When the Project is created, the subject is already predefined. The subject is defined as the topic "ZDP Projects" of the parent (ProjectFolder). In the Subject/Topic hierarchy the Subject "ZDP projects" already exists if there have been other projects defined earlier. In this case we only have to care for a new TopicFolder with the nickname "ZBook project". Someone who is allowed to add a Project should also have the right to add TopicFolders. If the Subject "ZDP projects" does not exist as a Subject, but only as a Topic of the ZDP TopicFolder, then the Subject "ZDP projects" would have to be created in a TopicFolder, and inside of it, a Topic of "ZBook project". The Subject/Topic hierarchy should break once we get too specialized. For example it may not make sense to give new Topics and Subjects to Comments that are also reflected in the Subject/Topic Hierarchy. The subjects and topics can perhaps still be there in the Documents, but they won't mess up the Subject/Topic hierarchy which needs to be kept small and clean, but could even so be kept small by filtering. Generally, we never choose Subject and Topic together because in the Document Hierarchy we build on the principle of containment, and we have no content flying around in mid-air. When you create a document in the document hierarchy you always get the subject for free from the topic of the partent folder. The Topics can be naturally fed from the Topics in a TopicFolder with the name of the subject when they exist. The Topics would be selectable in a selection list at the time we create a new document in the document hierarchy. Greetings, Maik Röder -- Open Source is "about being able to work together with people you've never met, on projects that are in a constant state of flux, on a time schedule that would cause a hummingbird's head to spin." Paul Ferris, http://www.linuxplanet.com/linuxplanet/opinions/1593/1/ From rik.hoekstra@inghist.nl Fri Apr 28 11:00:56 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Fri, 28 Apr 2000 12:00:56 +0200 Subject: [ZDP] Zope Documentation Portal References: <39095097.8058FBF3@berg.net> Message-ID: <39096158.8C7C7441@inghist.nl> Maik, I think this is a good idea. The design looks good at a first glance. Unfortunately I do not have time to look into it in detail. However, taking into account the discussions about the Portal Toolkit and documentation of the last few days, I have another proposal. Let's make it an official Zope Community Policy (TM) to make all documentation primarily available through the new Documentation Portal. And, to get personal ;-), this would also mean that DC makes a commitment to do so. In this way we'd create the necessary clarity in Zope documentation. In other words, more than a change of policy in the ZDP, let's make the Documentation Portal thing for and of the whole Zope Community. Comments? Rik From chrisw@nipltd.com Fri Apr 28 11:23:37 2000 From: chrisw@nipltd.com (Chris Withers) Date: Fri, 28 Apr 2000 11:23:37 +0100 Subject: [ZDP] Re: [Zope-PTK] Zope Documentation Portal References: <39095097.8058FBF3@berg.net> Message-ID: <390966A9.4565CB20@nipltd.com> After a very quick look, it sounds like a great idea ;-) How do we know what documentation applies to what Zope version? What's the difference between the above and documentation that has been corrected/abandoned because it was simply wrong/out of date and not just wrong for a version of Zope? Chris From tom.deprez@uz.kuleuven.ac.be Fri Apr 28 11:31:08 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Fri, 28 Apr 2000 12:31:08 +0200 Subject: [ZDP] Zope Documentation Portal In-Reply-To: <39095097.8058FBF3@berg.net> Message-ID: <3.0.6.32.20000428123108.00982e30@poirot> Nice idea, it looks something to the small knowledge base I've made. This MiniKnowledgebase has a TKBCategory. In this category a TKBItem can be placed. This KBItem contains a property linked to the 'nickname' of the category to which it belongs. This property is filled by an external method (thus when you move a topic to another Category, the contents of this property changes!). Generally I think it is a good idea to create the ZDPortal. However, I hope the way to generate the hierarchy wouldn't be too difficult or to slumbercome. Tom. At 10:49 28/04/2000 +0200, you wrote: >Hi everyone ! > > >I suggest changing the Zope Documentation Project to a >Zope Documentation Portal. This Portal would integrate a view >on the existing ZDP content and Zope.org content by creating >links to Zope.org documents and enrich these links with >meta-information. So even though not all documentation is >stored in one place, there can be one place from where all >documentation can be reached conveniently. > >To make Zope documentation available under certain subjects and topics >for different users, a new Portal ZClass is needed that provides >different views on the Information Space. The following is a >suggestion for implementation of the new Subject/Topic Hierarchy. >David Kankiewicz has already worked on this problem, and also >implemented part of it on the ZDP site. Nevertheless, I want >to throw in my thoughts on this, which came up as I tried to >understand Davids code ;-) The PTK project also works on this >problem, so I have CC'd this mail also to this list to exchange >some ideas. In the long term the ZDP-project needs to adopt >the PTK, and so discussing this early on could be beneficial. > >Create three new ZClasses: > >* TopicFolder (derived from DocumentFolder) > nickname: Subject > > In the root folder, there should be multiple TopicFolders for > each Subject. Subjects can be for example "DTML" and "Web Server". > Anyone can create TopicFolders, but unless they are approved, it > is not going to be publicly visible. > >* Topic (derived from Search) > nickname: Topic > > Under the TopicFolders, which define the Subjects, there should > be multiple Topics. Topics will find their contents through > a ZCatalog Search and so it makes sense to derive it from the > Search ZClass which already exists in the ZDP-Tools. As with > TopicFolders, they can be created by anyone, but must be > approved to get visible. > >* Portal (derived from DocumentFolder) > nickname: Recipient > > Portals filter the TopicFolders and Topics for interest groups, > defined by the Recipient nickname. A Portal can show the TopicFolders > with their abstract or show the TopicFolders with their Topics > as links in a Yahoo style. Portals are only added by Managers with > one exception. Portals may also be used to create a Personalized > view on the information space for members. Members may want to > put their own Portal(s) into their MemberClass. The Recipient variable > would in this case just be user defined, and default to the member > login name. > >When the Subject/Topic hierarchy is built, then it can be displayed >very fast inside a Portal without using ZCatalog. The ZCatalog search >starts inside the Topics for the first time. When a Topic is displayed, >a Search is performed with the following parameters: > > * Subject = TopicFolder.nickname > * Topic = Topic.nickname > * Recipient = Portal.nickname > >This should keep the number of results rather small. We are already >deep in a context and filter on the Recipient. This could be further >reduced by introducing new filters like for example "zen_level". > >So, as a consequence we have to give every ZClass the following >properties so we can search on them in the document hierarchy >using ZCatalog: > > DocumentFolder > Subject > Topic > Recipient > >Now, let's see how document creation would look like. When we create >a document, we are always somewhere in the document hierarchy, and >can always assume that we are in the context of a subject and a topic. >This can be solved by making the following subject and topic default: > > Root (/ of zdp.zope.org): > subject: Zope > topic: ZDP > >Let's look at an example of how the subject/topic hierarchy is >interwoven in the document hierarchy: > > * Root (nickname: ZDP: Zope Documentation Project) > subject: Zope > topic: ZDP > > * Project Folder (nickname: Projects) > subject: ZDP > topic: ZDP projects > > * Project (nickname: ZDP-Tools) > subject: ZDP projects > topic: ZDP-Tools project > > * ProductDocumentation (nickname: Documentation) > subject: ZDP-Tools project > topic: ZDP-Tools Documentation > >Please notice that the subjects are always the topics of >the parent folder. > >To see where we take the subjects and topics from when >adding a new document to the document hierarchy, we have >a look at an example: > >Let's suppose we want to add a new Project called ZBook to the >document hierarchy under the Project Folder: > > * ProjectFolder (nickname Projects) > subject: ZDP > topic: ZDP projects > > * Project (nickname: ZBook) > subject: ZDP projects > topic: ZBook project > >When the Project is created, the subject is already predefined. >The subject is defined as the topic "ZDP Projects" of the >parent (ProjectFolder). > >In the Subject/Topic hierarchy the Subject "ZDP projects" already >exists if there have been other projects defined earlier. In this >case we only have to care for a new TopicFolder with the nickname >"ZBook project". Someone who is allowed to add a Project should >also have the right to add TopicFolders. > >If the Subject "ZDP projects" does not exist as a Subject, but only >as a Topic of the ZDP TopicFolder, then the Subject "ZDP projects" >would have to be created in a TopicFolder, and inside of it, a >Topic of "ZBook project". > >The Subject/Topic hierarchy should break once we get too specialized. >For example it may not make sense to give new Topics and Subjects to >Comments that are also reflected in the Subject/Topic Hierarchy. >The subjects and topics can perhaps still be there in the Documents, >but they won't mess up the Subject/Topic hierarchy which needs to >be kept small and clean, but could even so be kept small by filtering. > >Generally, we never choose Subject and Topic together because >in the Document Hierarchy we build on the principle of containment, >and we have no content flying around in mid-air. When you create >a document in the document hierarchy you always get the subject >for free from the topic of the partent folder. The Topics >can be naturally fed from the Topics in a TopicFolder with the >name of the subject when they exist. The Topics would be selectable >in a selection list at the time we create a new document in the >document hierarchy. > > >Greetings, > >Maik Röder > >-- >Open Source is "about being able to work together with people you've >never met, on projects that are in a constant state of flux, on >a time schedule that would cause a hummingbird's head to spin." >Paul Ferris, http://www.linuxplanet.com/linuxplanet/opinions/1593/1/ > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From tom.deprez@uz.kuleuven.ac.be Fri Apr 28 11:32:57 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Fri, 28 Apr 2000 12:32:57 +0200 Subject: [ZDP] Zope Documentation Portal In-Reply-To: <39096158.8C7C7441@inghist.nl> References: <39095097.8058FBF3@berg.net> Message-ID: <3.0.6.32.20000428123257.00981ca0@poirot> At 12:00 28/04/2000 +0200, Rik Hoekstra wrote: >Maik, > >I think this is a good idea. The design looks good at a first glance. >Unfortunately I do not have time to look into it in detail. >However, taking into account the discussions about the Portal Toolkit >and documentation of the last few days, I have another proposal. Let's >make it an official Zope Community Policy (TM) to make all documentation >primarily available through the new Documentation Portal. And, to get >personal ;-), this would also mean that DC makes a commitment to do so. >In this way we'd create the necessary clarity in Zope documentation. > >In other words, more than a change of policy in the ZDP, let's make the >Documentation Portal thing for and of the whole Zope Community. > >Comments? Yup. As we proposed in one of our previous discussions with DC. >Rik > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From kayeva@hotmail.com Fri Apr 28 11:43:10 2000 From: kayeva@hotmail.com (kamon ayeva) Date: Fri, 28 Apr 2000 10:43:10 GMT Subject: [ZDP] Zope Documentation Portal Message-ID: <20000428104310.45186.qmail@hotmail.com> Hi, >Hi everyone ! > > >I suggest changing the Zope Documentation Project to a >Zope Documentation Portal. I agree since ZDP is more than a project now. It should be a reality and a way of living. >This Portal would integrate a view >on the existing ZDP content and Zope.org content by creating >links to Zope.org documents and enrich these links with >meta-information. So even though not all documentation is >stored in one place, there can be one place from where all >documentation can be reached conveniently. Great idea. It would be good if PTK and ZDP-Tools efforts could join to agree on common API's. Will come up later for technical discussion. Regards, Kamon ________________________________________________________________________ Get Your Private, Free E-mail from MSN Hotmail at http://www.hotmail.com From tom.deprez@uz.kuleuven.ac.be Fri Apr 28 11:52:32 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Fri, 28 Apr 2000 12:52:32 +0200 Subject: [ZDP] Zope Documentation Portal In-Reply-To: <3.0.6.32.20000428123108.00982e30@poirot> References: <39095097.8058FBF3@berg.net> Message-ID: <3.0.6.32.20000428125232.009723b0@poirot> Humph, I realise that my prev explenation was a little bit outdated. It our the categories which contain a string of the categories in which it exists. The KBItem contain nothing. A ZCatalog, searches the categories 'category' property. Thus moving a category also changes its category string. Now when I person searches for a certain 'key'. The ZCatalog looks into its categories and viola we got the items... (I remember I changed this after I've read a comment of Rik). Just to say that we could manage to create our hierarchy also like this, but then of course in a much more extended way. Tom. >This MiniKnowledgebase has a TKBCategory. In this category a TKBItem can be >placed. This KBItem contains a property linked to the 'nickname' of the >category to which it belongs. This property is filled by an external method >(thus when you move a topic to another Category, the contents of this >property changes!). >Generally I think it is a good idea to create the ZDPortal. However, I hope >the way to generate the hierarchy wouldn't be too difficult or to slumbercome. > >Tom. > > >At 10:49 28/04/2000 +0200, you wrote: >>Hi everyone ! >> >> >>I suggest changing the Zope Documentation Project to a >>Zope Documentation Portal. This Portal would integrate a view >>on the existing ZDP content and Zope.org content by creating >>links to Zope.org documents and enrich these links with >>meta-information. So even though not all documentation is >>stored in one place, there can be one place from where all >>documentation can be reached conveniently. >> >>To make Zope documentation available under certain subjects and topics >>for different users, a new Portal ZClass is needed that provides >>different views on the Information Space. The following is a >>suggestion for implementation of the new Subject/Topic Hierarchy. >>David Kankiewicz has already worked on this problem, and also >>implemented part of it on the ZDP site. Nevertheless, I want >>to throw in my thoughts on this, which came up as I tried to >>understand Davids code ;-) The PTK project also works on this >>problem, so I have CC'd this mail also to this list to exchange >>some ideas. In the long term the ZDP-project needs to adopt >>the PTK, and so discussing this early on could be beneficial. >> >>Create three new ZClasses: >> >>* TopicFolder (derived from DocumentFolder) >> nickname: Subject >> >> In the root folder, there should be multiple TopicFolders for >> each Subject. Subjects can be for example "DTML" and "Web Server". >> Anyone can create TopicFolders, but unless they are approved, it >> is not going to be publicly visible. >> >>* Topic (derived from Search) >> nickname: Topic >> >> Under the TopicFolders, which define the Subjects, there should >> be multiple Topics. Topics will find their contents through >> a ZCatalog Search and so it makes sense to derive it from the >> Search ZClass which already exists in the ZDP-Tools. As with >> TopicFolders, they can be created by anyone, but must be >> approved to get visible. >> >>* Portal (derived from DocumentFolder) >> nickname: Recipient >> >> Portals filter the TopicFolders and Topics for interest groups, >> defined by the Recipient nickname. A Portal can show the TopicFolders >> with their abstract or show the TopicFolders with their Topics >> as links in a Yahoo style. Portals are only added by Managers with >> one exception. Portals may also be used to create a Personalized >> view on the information space for members. Members may want to >> put their own Portal(s) into their MemberClass. The Recipient variable >> would in this case just be user defined, and default to the member >> login name. >> >>When the Subject/Topic hierarchy is built, then it can be displayed >>very fast inside a Portal without using ZCatalog. The ZCatalog search >>starts inside the Topics for the first time. When a Topic is displayed, >>a Search is performed with the following parameters: >> >> * Subject = TopicFolder.nickname >> * Topic = Topic.nickname >> * Recipient = Portal.nickname >> >>This should keep the number of results rather small. We are already >>deep in a context and filter on the Recipient. This could be further >>reduced by introducing new filters like for example "zen_level". >> >>So, as a consequence we have to give every ZClass the following >>properties so we can search on them in the document hierarchy >>using ZCatalog: >> >> DocumentFolder >> Subject >> Topic >> Recipient >> >>Now, let's see how document creation would look like. When we create >>a document, we are always somewhere in the document hierarchy, and >>can always assume that we are in the context of a subject and a topic. >>This can be solved by making the following subject and topic default: >> >> Root (/ of zdp.zope.org): >> subject: Zope >> topic: ZDP >> >>Let's look at an example of how the subject/topic hierarchy is >>interwoven in the document hierarchy: >> >> * Root (nickname: ZDP: Zope Documentation Project) >> subject: Zope >> topic: ZDP >> >> * Project Folder (nickname: Projects) >> subject: ZDP >> topic: ZDP projects >> >> * Project (nickname: ZDP-Tools) >> subject: ZDP projects >> topic: ZDP-Tools project >> >> * ProductDocumentation (nickname: Documentation) >> subject: ZDP-Tools project >> topic: ZDP-Tools Documentation >> >>Please notice that the subjects are always the topics of >>the parent folder. >> >>To see where we take the subjects and topics from when >>adding a new document to the document hierarchy, we have >>a look at an example: >> >>Let's suppose we want to add a new Project called ZBook to the >>document hierarchy under the Project Folder: >> >> * ProjectFolder (nickname Projects) >> subject: ZDP >> topic: ZDP projects >> >> * Project (nickname: ZBook) >> subject: ZDP projects >> topic: ZBook project >> >>When the Project is created, the subject is already predefined. >>The subject is defined as the topic "ZDP Projects" of the >>parent (ProjectFolder). >> >>In the Subject/Topic hierarchy the Subject "ZDP projects" already >>exists if there have been other projects defined earlier. In this >>case we only have to care for a new TopicFolder with the nickname >>"ZBook project". Someone who is allowed to add a Project should >>also have the right to add TopicFolders. >> >>If the Subject "ZDP projects" does not exist as a Subject, but only >>as a Topic of the ZDP TopicFolder, then the Subject "ZDP projects" >>would have to be created in a TopicFolder, and inside of it, a >>Topic of "ZBook project". >> >>The Subject/Topic hierarchy should break once we get too specialized. >>For example it may not make sense to give new Topics and Subjects to >>Comments that are also reflected in the Subject/Topic Hierarchy. >>The subjects and topics can perhaps still be there in the Documents, >>but they won't mess up the Subject/Topic hierarchy which needs to >>be kept small and clean, but could even so be kept small by filtering. >> >>Generally, we never choose Subject and Topic together because >>in the Document Hierarchy we build on the principle of containment, >>and we have no content flying around in mid-air. When you create >>a document in the document hierarchy you always get the subject >>for free from the topic of the partent folder. The Topics >>can be naturally fed from the Topics in a TopicFolder with the >>name of the subject when they exist. The Topics would be selectable >>in a selection list at the time we create a new document in the >>document hierarchy. >> >> >>Greetings, >> >>Maik Röder >> >>-- >>Open Source is "about being able to work together with people you've >>never met, on projects that are in a constant state of flux, on >>a time schedule that would cause a hummingbird's head to spin." >>Paul Ferris, http://www.linuxplanet.com/linuxplanet/opinions/1593/1/ >> >>_______________________________________________ >>ZDP maillist - ZDP@zope.org >>http://lists.zope.org/mailman/listinfo/zdp >> >> > >_______________________________________________ >ZDP maillist - ZDP@zope.org >http://lists.zope.org/mailman/listinfo/zdp > > From mroe@axion-gmbh.de Fri Apr 28 14:49:17 2000 From: mroe@axion-gmbh.de (Maik =?iso-8859-1?Q?R=F6der?=) Date: Fri, 28 Apr 2000 14:49:17 +0100 Subject: [ZDP] Zope Documentation Portal Community Policy Message-ID: <390996DD.6EA2BA8C@axion-gmbh.de> Hi ! [Rik:] > However, taking into account the discussions about the Portal Toolkit > and documentation of the last few days, I have another proposal. Let's > make it an official Zope Community Policy (TM) to make all documentation > primarily available through the new Documentation Portal. I think we should steer in this direction, but the first rule is Linus's motto of "Show me the code", and then we can talk about moving the whole process of Documentation to ZDP if all parties agree an this. I would like to develop this system like a prototype at first, and if it works, we can approach the Zope community and Digital Creations to ask them to make the documentation available via ZDP only. > And, to get personal ;-), this would also mean that DC makes a commitment > to do so. In this way we'd create the necessary clarity in Zope documentation. It would be great if DC would collaborate more with the ZDP, but as long as this is not the case, we can only do the second best thing, and provide a solution that just links to what is available on zope.org. It would be a big improvement even if noone collaborated, but let's not get too pessimistic ;-) >In other words, more than a change of policy in the ZDP, let's make the >Documentation Portal thing for and of the whole Zope Community. Agreed. [Chris Withers:] >How do we know what documentation applies to what Zope version? We have been talking about this, but we have not yet come to a solution. I don't think it would be great to add a version property to all documents. Instead, I would like to store the creation date explicitely and infer the Zope version from it. >What's the difference between the above and documentation that has been >corrected/abandoned because it was simply wrong/out of date and not just wrong >for a version of Zope? Wrong documentation can appear in the best content management system. As long as peer review does not take place bad documentation remains bad. We are planning a system where a Reviewer can select outdated stuff which will stay there for a while and be removed by an Approver perhaps after checking back with the Maintainer. [Tom:] > Nice idea, it looks something to the small knowledge base I've made. If I understand you right, the following ZClasses are the same in your KB and in the ZD Portal: TopicFolder = TKBCategory Topic = TKBItem TKBCategory objects contain a string of the categories in which they exists TKBCategory objects contain TKBItem objects. The KBItems contain nothing. A ZCatalog searches for the TKBCategory objects 'category' property. A search for the category leads to the TKBItems by going to the TKBCategory Folders and listing all it's items ? > Generally I think it is a good idea to create the ZDPortal. However, I hope > the way to generate the hierarchy wouldn't be too difficult or to > slumbercome. The hierarchy is created on the fly while adding documents. The subject of every object is always the topic of the parent. Therefore you only have to specify a Topic. There are as many Topics to choose from as there are Topics in the Subject it is created under. If the Subject or Topic does not yet exist, it can be created dynamically, successively building up a hierarchy. This process can be moderated. [Kamon:] > It would be good if PTK and ZDP-Tools efforts could join to agree on common > API's. Right, can someone from the PTK mailing list comment on this ? Greetings, Maik Röder From tom.deprez@uz.kuleuven.ac.be Fri Apr 28 14:28:15 2000 From: tom.deprez@uz.kuleuven.ac.be (Tom Deprez) Date: Fri, 28 Apr 2000 15:28:15 +0200 Subject: [ZDP] Zope Documentation Portal Community Policy In-Reply-To: <390996DD.6EA2BA8C@axion-gmbh.de> Message-ID: <3.0.6.32.20000428152815.009609d0@poirot> >> However, taking into account the discussions about the Portal Toolkit >> and documentation of the last few days, I have another proposal. Let's >> make it an official Zope Community Policy (TM) to make all documentation >> primarily available through the new Documentation Portal. > >I think we should steer in this direction, but the first rule is Linus's motto >of "Show me the code", and then we can talk about moving the whole process of >Documentation to ZDP if all parties agree an this. > >I would like to develop this system like a prototype at first, and if it >works, we can approach the Zope community and Digital Creations to ask them >to make the documentation available via ZDP only. Correct! >>How do we know what documentation applies to what Zope version? > >We have been talking about this, but we have not yet come to a solution. >I don't think it would be great to add a version property to all >documents. Instead, I would like to store the creation date explicitely >and infer the Zope version from it. > >>What's the difference between the above and documentation that has been >>corrected/abandoned because it was simply wrong/out of date and not just wrong >>for a version of Zope? > >Wrong documentation can appear in the best content management system. As >long as peer review does not take place bad documentation remains bad. >We are planning a system where a Reviewer can select outdated stuff which >will stay there for a while and be removed by an Approver perhaps after >checking back with the Maintainer. Another problem is that some things go along over several versions and others not... >[Tom:] >> Nice idea, it looks something to the small knowledge base I've made. > >If I understand you right, the following ZClasses are >the same in your KB and in the ZD Portal: > >TopicFolder = TKBCategory >Topic = TKBItem > >TKBCategory objects contain a string of the categories in which they exists >TKBCategory objects contain TKBItem objects. The KBItems contain nothing. >A ZCatalog searches for the TKBCategory objects 'category' property. >A search for the category leads to the TKBItems by going to the TKBCategory >Folders and listing all it's items ? yup, but of course the items contains a property which holds the problem and the items contain the solutions (a solution class) to this problem. >> Generally I think it is a good idea to create the ZDPortal. However, I hope >> the way to generate the hierarchy wouldn't be too difficult or to >> slumbercome. > >The hierarchy is created on the fly while adding documents. The subject of >every object is always the topic of the parent. Therefore you only have >to specify a Topic. There are as many Topics to choose from as there are >Topics in the Subject it is created under. If the Subject or Topic does not >yet exist, it can be created dynamically, successively building up a hierarchy. >This process can be moderated. OK > From zope@teleo.net Fri Apr 28 16:53:34 2000 From: zope@teleo.net (Patrick Phalen) Date: Fri, 28 Apr 2000 08:53:34 -0700 Subject: [ZDP] Re: [Zope-PTK] Zope Documentation Portal In-Reply-To: <39095097.8058FBF3@berg.net> References: <39095097.8058FBF3@berg.net> Message-ID: <00042809010901.06396@quadra.teleo.net> [Maik Roeder, on Fri, 28 Apr 2000] :: I suggest changing the Zope Documentation Project to a :: Zope Documentation Portal. :: The PTK project also works on this problem, :: so I have CC'd this mail also to this list to exchange :: some ideas. In the long term the ZDP-project needs to adopt :: the PTK, and so discussing this early on could be beneficial. This is, of course, a natural idea. However, the ZDP list folks may not be aware of a recent development on the Zope-PTK front. I'm copying Paul Everitt's announcement below. To move forward will require settling some of the uncertainty this brings. _________________ [Forwarded message]: [Zope-PTK] FYI: Sad news for PTK From: Paul Everitt To: "'zope-ptk@zope.org'" Howdy sports fans. I'm a bit overdue on delivering this news. Many of you know that Mike Pelletier has been the primary developer and owner of PTK. As I reported last week, Mike had to take some time off to take care of some family matters. Unfortunately for all of us, the time away needs to be more permanent. First, I'd like to give Mike a big round of applause for taking charge of the PTK and crafting it into something truly engaging for the Zope community. Mike has been wonderful to work with and has really shown a great touch in being engaged on this project and staying ahead of bugs and features. I wish him the best of luck in his next step. However, this puts the PTK in a bad spot. We at Digital Creations are growing rapidly, but we're still resource starved for community projects like this. Bluntly stated, the prognosis in the very near term isn't good for us to be the sole developer of the PTK. Thus, there's a clear choice at hand: o PTK cools off for some period of time. o PTK becomes an Open Source _development_ project, with many people getting checkin authority. I'll leave the commentary out for this first round and open up the floor for comments. --Paul Paul Everitt Digital Creations From rik.hoekstra@inghist.nl Fri Apr 28 17:06:22 2000 From: rik.hoekstra@inghist.nl (Rik Hoekstra) Date: Fri, 28 Apr 2000 18:06:22 +0200 Subject: [ZDP] Zope Documentation Portal Community Policy Message-ID: <002701bfb12b$b30dcf40$fe5da182@etgriend.et.tudelft.nl> Hi ! [Rik:] > However, taking into account the discussions about the Portal Toolkit > and documentation of the last few days, I have another proposal. Let's > make it an official Zope Community Policy (TM) to make all documentation > primarily available through the new Documentation Portal. [Maik] I think we should steer in this direction, but the first rule is Linus's motto of "Show me the code", and then we can talk about moving the whole process of Documentation to ZDP if all parties agree an this. [rh]Yes, of course. But I've seen your efforts before, and I take the quality for granted ;-) I would like to develop this system like a prototype at first, and if it works, we can approach the Zope community and Digital Creations to ask them to make the documentation available via ZDP only. > And, to get personal ;-), this would also mean that DC makes a commitment > to do so. In this way we'd create the necessary clarity in Zope documentation. It would be great if DC would collaborate more with the ZDP, but as long as this is not the case, we can only do the second best thing, and provide a solution that just links to what is available on zope.org. It would be a big improvement even if noone collaborated, but let's not get too pessimistic ;-) [rh]Nothing pessimistic here, just the right time to kick this in once more. I thought >In other words, more than a change of policy in the ZDP, let's make the >Documentation Portal thing for and of the whole Zope Community. Agreed. [Chris Withers:] >How do we know what documentation applies to what Zope version? We have been talking about this, but we have not yet come to a solution. I don't think it would be great to add a version property to all documents. Instead, I would like to store the creation date explicitely and infer the Zope version from it. [rh]Hm, fancy. Don't know if this is necessary though. Rik From chrisw@nipltd.com Fri Apr 28 17:31:40 2000 From: chrisw@nipltd.com (Chris Withers) Date: Fri, 28 Apr 2000 17:31:40 +0100 Subject: [ZDP] Zope Documentation Portal Community Policy References: <002701bfb12b$b30dcf40$fe5da182@etgriend.et.tudelft.nl> Message-ID: <3909BCEC.F70F02D3@nipltd.com> It strikes me that this discussion is excellent, but it's spread across two lists, and the messages are getting unreadable there's so much quoting. Anyone for a Wiki? ;-) If someone else doesn't want to do one, give me a shout and I will @:-) cheers, Chris Rik Hoekstra wrote: > > Hi ! > > [Rik:] > > However, taking into account the discussions about the Portal Toolkit > > and documentation of the last few days, I have another proposal. Let's > > make it an official Zope Community Policy (TM) to make all documentation > > primarily available through the new Documentation Portal. > > [Maik] > I think we should steer in this direction, but the first rule is Linus's > motto > of "Show me the code", and then we can talk about moving the whole process > of > Documentation to ZDP if all parties agree an this. > > [rh]Yes, of course. But I've seen your efforts before, and I take the > quality for granted ;-) > > I would like to develop this system like a prototype at first, and if it > works, we can approach the Zope community and Digital Creations to ask them > to make the documentation available via ZDP only. > > > And, to get personal ;-), this would also mean that DC makes a commitment > > to do so. In this way we'd create the necessary clarity in Zope > documentation. > > It would be great if DC would collaborate more with the ZDP, but as long > as this is not the case, we can only do the second best thing, and provide > a solution that just links to what is available on zope.org. It would > be a big improvement even if noone collaborated, but let's not get too > pessimistic ;-) > > [rh]Nothing pessimistic here, just the right time to kick this in once more. > I thought > > >In other words, more than a change of policy in the ZDP, let's make the > >Documentation Portal thing for and of the whole Zope Community. > > Agreed. > > [Chris Withers:] > >How do we know what documentation applies to what Zope version? > > We have been talking about this, but we have not yet come to a solution. > I don't think it would be great to add a version property to all > documents. Instead, I would like to store the creation date explicitely > and infer the Zope version from it. > > [rh]Hm, fancy. Don't know if this is necessary though. > > > > Rik > > _______________________________________________ > ZDP maillist - ZDP@zope.org > http://lists.zope.org/mailman/listinfo/zdp From msimcich@accesstools.com Fri Apr 28 17:42:28 2000 From: msimcich@accesstools.com (Michael Simcich) Date: Fri, 28 Apr 2000 09:42:28 -0700 Subject: [ZDP] Zope Documentation Portal Community Policy In-Reply-To: <002701bfb12b$b30dcf40$fe5da182@etgriend.et.tudelft.nl> Message-ID: <003001bfb130$bdf1f300$0100a8c0@pinol1.sfba.home.com> Hi all - Sounds like a great bunch of ideas to me. I've been researching something like this for quite a while now, but since my level of zope zen is quite low, I may not be able to contribute much beyond moral support. Regarding this part: >>How do we know what documentation applies to what Zope version? >We have been talking about this, but we have not yet come to a solution. >I don't think it would be great to add a version property to all >documents. Instead, I would like to store the creation date explicitely >and infer the Zope version from it. I don't know if it's a practical approach. It's likely that much new documentation would apply equally to older versions of Zope, so not too much could be inferred from testing the doc date against a Zope release date. Unless I'm missing something? Maybe something like a ver property isn't very appealing, but it would be practical. Michael Simcich AccessTools From roeder@berg.net Sun Apr 30 21:16:34 2000 From: roeder@berg.net (Maik Roeder) Date: Sun, 30 Apr 2000 22:16:34 +0200 Subject: [ZDP] ZDP site down Message-ID: <390C94A2.DCF70C34@berg.net> Hi ! The ZDP site is down right now because the disk quota has been exceeded, and packing did not work. Sorry, I should have packed the server more often :-( I have Mailed Codeit for assistance. BTW: I have worked a lot on the new Portals, and have got the system working. There is still very much work involved in assigning Subjects, Topics and Communities, defining all Portals and filling the Portals with the stuff that is interesting for the Portal Communities. In the course of implementing I have cleared and recataloged the Catalog very often, and this must have caused the growth of the Data.fs. Greetings, Maik Röder -- Open Source is "about being able to work together with people you've never met, on projects that are in a constant state of flux, on a time schedule that would cause a hummingbird's head to spin." Paul Ferris, http://www.linuxplanet.com/linuxplanet/opinions/1593/1/