Re: [Zope] "The Zope Book"
On Fri, Apr 08, 2005 at 06:58:31PM +0200, Dieter Maurer wrote: > Lennart Regebro wrote at 2005-4-8 10:59 +0200: > > ... > >On Apr 8, 2005 8:48 AM, Chris Withers <[EMAIL PROTECTED]> wrote: > > ... > >> Which "The Zope Book" are you referring to? > >> > >> The 2.6 one on Zope.org? > >> The 2.7 one on Plope.com? > >> The 3.whatever one somewhere-I-don't-know? > > > >I would expect it to be "featured", that is mentioned as a recommended > >practice, in a Zope2.9 book, should one appear. I also thonk that with > >2.8 a 2.8 book should be released, which main feature could be to move > >the ZClass part to an appendix. > > Indead, something along this line... Considering that we still have not finished the "2.7" edition of the book, I find it very unlikely that we will manage to get something out in sync with the first zope 2.8 release. Anyone who wishes to help us edit the book is encouraged to visit http://plope.com/Books/zb_signup -- Paul Winkler http://www.slinkp.com ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
Lennart Regebro wrote at 2005-4-8 10:59 +0200: > ... >On Apr 8, 2005 8:48 AM, Chris Withers <[EMAIL PROTECTED]> wrote: > ... >> Which "The Zope Book" are you referring to? >> >> The 2.6 one on Zope.org? >> The 2.7 one on Plope.com? >> The 3.whatever one somewhere-I-don't-know? > >I would expect it to be "featured", that is mentioned as a recommended >practice, in a Zope2.9 book, should one appear. I also thonk that with >2.8 a 2.8 book should be released, which main feature could be to move >the ZClass part to an appendix. Indead, something along this line... -- Dieter ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
No, sorry. THe canonical version is on the web. - C On Tue, 2005-04-12 at 04:10, Dario Lopez-KÃsten wrote: > Chris McDonough wrote: > > I don't think anyone has given much thought to actually documenting all > > these nice nifty features in 2.9. Which is no change from the norm, and > > it will be a fairly organic process again. I hate it, but whatever. > > > > - C > > > > Speaking of which, and being one of the people that promised to deliver > but has not done so 100% yet, is it possible to checkout the Zope Book > from cvs or svn? > > That'd help a lot in terms of incrementally adding stuff, at least for me. > > Thanks, > > /dario ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
Chris McDonough wrote: I don't think anyone has given much thought to actually documenting all these nice nifty features in 2.9. Which is no change from the norm, and it will be a fairly organic process again. I hate it, but whatever. - C Speaking of which, and being one of the people that promised to deliver but has not done so 100% yet, is it possible to checkout the Zope Book from cvs or svn? That'd help a lot in terms of incrementally adding stuff, at least for me. Thanks, /dario -- -- --- Dario Lopez-Kästen, IT Systems & Services Chalmers University of Tech. "...and click? damn, I need to kill -9 Word again..." - b using macosx ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
On Friday 08 April 2005 11:22, Paul Winkler wrote: > The primary problem with the Zope Book is still the relative scarcity of > resources (i.e. editors with time to work on it). > > The secondary problem with the Zope Book is that it's showing its age: > the choice and organization of topics is IMHO less than ideal, but that > can't be sufficiently addressed on a chapter-by-chapter basis, one needs > to have a good overview of the whole project. This vastly increases the > scope of the task. Note that my Zope 3 book is published under CC license. I could ask SAMS whether it would be okay to include parts (with proper reference and copyright notice) in the online version of the Zope 2 book. That will not document Five, but some of the component architecture. Regards, Stephan -- Stephan Richter CBU Physics & Chemistry (B.S.) / Tufts Physics (Ph.D. student) Web2k - Web Software Design, Development and Training ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
On Fri, Apr 08, 2005 at 06:06:57PM +0200, Lennart Regebro wrote: > On Apr 8, 2005 5:59 PM, Paul Winkler <[EMAIL PROTECTED]> wrote: > > Well, the chapter-by-chapter editing is still not done. > > See http://plope.com/Books/zb_signup for an overview of the known > > tasks to be done. > > OK, but that's better than expected, I'd say. :) It sais "Finished" on > a whole bunch of chapters. Yep! But only about half. Current stats for anyone who cares: Finished15 In Progress 12 Not Started 1 Unclaimed 4 -- Paul Winkler http://www.slinkp.com ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
On Apr 8, 2005 5:59 PM, Paul Winkler <[EMAIL PROTECTED]> wrote: > OK, but there should at least be a pointer to something to read > for people wanting to get started with 2.8.0/Five. > I haven't yet looked at any of the Five stuff. > Is there at least a README? :) Sure. I don't guarantee that it's remotely relevant, however. :-) > Well, the chapter-by-chapter editing is still not done. > See http://plope.com/Books/zb_signup for an overview of the known > tasks to be done. OK, but that's better than expected, I'd say. :) It sais "Finished" on a whole bunch of chapters. -- Lennart Regebro, Nuxeo http://www.nuxeo.com/ CPS Content Management http://www.cps-project.org/ ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
On Fri, Apr 08, 2005 at 05:41:30PM +0200, Lennart Regebro wrote: > On Apr 8, 2005 5:22 PM, Paul Winkler <[EMAIL PROTECTED]> wrote: > > But that leaves unanswered questions - should we document the Five stuff > > at all, and if so, how? > > Well, the Five stuff is a subset of the Zope3 stuff, with way too much > Zope2 stuff still necessary. The idea is that this should change quite > rapidly and get more and more Zope3-ish and become less and less of a > subset. > > So it may be that documenting it is a bit of a waste of time. I think > the most realistic part is to rename the 2.7 book to 2.8, move > ZClasses and DTML last, note that 2.8 includes some Zope3 support but > don't document it. OK, but there should at least be a pointer to something to read for people wanting to get started with 2.8.0/Five. I haven't yet looked at any of the Five stuff. Is there at least a README? :) > Then we'll concentrate on getting 2.9s Zope3 support to be more > Zope3-ish, and documenting the differences into a Zope2.9 book. ;) Yes, I'm sure we will ;-) > I don't have an overview of what needs to be done on the Zope book in > general though. Well, the chapter-by-chapter editing is still not done. See http://plope.com/Books/zb_signup for an overview of the known tasks to be done. -- Paul Winkler http://www.slinkp.com ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
On Apr 8, 2005 5:22 PM, Paul Winkler <[EMAIL PROTECTED]> wrote: > But that leaves unanswered questions - should we document the Five stuff > at all, and if so, how? Well, the Five stuff is a subset of the Zope3 stuff, with way too much Zope2 stuff still necessary. The idea is that this should change quite rapidly and get more and more Zope3-ish and become less and less of a subset. So it may be that documenting it is a bit of a waste of time. I think the most realistic part is to rename the 2.7 book to 2.8, move ZClasses and DTML last, note that 2.8 includes some Zope3 support but don't document it. Then we'll concentrate on getting 2.9s Zope3 support to be more Zope3-ish, and documenting the differences into a Zope2.9 book. ;) I don't have an overview of what needs to be done on the Zope book in general though. -- Lennart Regebro, Nuxeo http://www.nuxeo.com/ CPS Content Management http://www.cps-project.org/ ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
I don't think anyone has given much thought to actually documenting all these nice nifty features in 2.9. Which is no change from the norm, and it will be a fairly organic process again. I hate it, but whatever. - C On Fri, 2005-04-08 at 11:22, Paul Winkler wrote: > On Fri, Apr 08, 2005 at 10:59:46AM +0200, Lennart Regebro wrote: > > On Apr 8, 2005 8:48 AM, Chris Withers <[EMAIL PROTECTED]> wrote: > > > Dieter Maurer wrote: > > > > When will they feature in *the* "Zope Book"? > > > > > > Which "The Zope Book" are you referring to? > > > > > > The 2.6 one on Zope.org? > > > The 2.7 one on Plope.com? > > > The 3.whatever one somewhere-I-don't-know? > > > > I would expect it to be "featured", that is mentioned as a recommended > > practice, in a Zope2.9 book, should one appear. I also thonk that with > > 2.8 a 2.8 book should be released, which main feature could be to move > > the ZClass part to an appendix. > > I would love that. But in the present day, we haven't even finished the > 2.7 book. I suppose we could just change the book's release number from > 2.7 to 2.8 and hope that's adequate ;-) > > But that leaves unanswered questions - should we document the Five stuff > at all, and if so, how? > > The primary problem with the Zope Book is still the relative scarcity of > resources (i.e. editors with time to work on it). > > The secondary problem with the Zope Book is that it's showing its age: > the choice and organization of topics is IMHO less than ideal, but that > can't be sufficiently addressed on a chapter-by-chapter basis, one needs > to have a good overview of the whole project. This vastly increases the > scope of the task. > > Sadly I can't see the status quo changing unless somebody wants to > invest sufficient money in the project so that some of the independent > contractors involved could schedule work on the book as an actual paying > job. Hopefully one of two things will happen: > > * I will be proven wrong, or > * such money will materialize somehow :-) ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
On Fri, Apr 08, 2005 at 10:59:46AM +0200, Lennart Regebro wrote: > On Apr 8, 2005 8:48 AM, Chris Withers <[EMAIL PROTECTED]> wrote: > > Dieter Maurer wrote: > > > When will they feature in *the* "Zope Book"? > > > > Which "The Zope Book" are you referring to? > > > > The 2.6 one on Zope.org? > > The 2.7 one on Plope.com? > > The 3.whatever one somewhere-I-don't-know? > > I would expect it to be "featured", that is mentioned as a recommended > practice, in a Zope2.9 book, should one appear. I also thonk that with > 2.8 a 2.8 book should be released, which main feature could be to move > the ZClass part to an appendix. I would love that. But in the present day, we haven't even finished the 2.7 book. I suppose we could just change the book's release number from 2.7 to 2.8 and hope that's adequate ;-) But that leaves unanswered questions - should we document the Five stuff at all, and if so, how? The primary problem with the Zope Book is still the relative scarcity of resources (i.e. editors with time to work on it). The secondary problem with the Zope Book is that it's showing its age: the choice and organization of topics is IMHO less than ideal, but that can't be sufficiently addressed on a chapter-by-chapter basis, one needs to have a good overview of the whole project. This vastly increases the scope of the task. Sadly I can't see the status quo changing unless somebody wants to invest sufficient money in the project so that some of the independent contractors involved could schedule work on the book as an actual paying job. Hopefully one of two things will happen: * I will be proven wrong, or * such money will materialize somehow :-) -- Paul Winkler http://www.slinkp.com ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
Re: [Zope] "The Zope Book"
On Apr 8, 2005 8:48 AM, Chris Withers <[EMAIL PROTECTED]> wrote: > Dieter Maurer wrote: > > When will they feature in *the* "Zope Book"? > > Which "The Zope Book" are you referring to? > > The 2.6 one on Zope.org? > The 2.7 one on Plope.com? > The 3.whatever one somewhere-I-don't-know? I would expect it to be "featured", that is mentioned as a recommended practice, in a Zope2.9 book, should one appear. I also thonk that with 2.8 a 2.8 book should be released, which main feature could be to move the ZClass part to an appendix. -- Lennart Regebro, Nuxeo http://www.nuxeo.com/ CPS Content Management http://www.cps-project.org/ ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
[Zope] "The Zope Book"
Dieter Maurer wrote: When will they feature in *the* "Zope Book"? Which "The Zope Book" are you referring to? The 2.6 one on Zope.org? The 2.7 one on Plope.com? The 3.whatever one somewhere-I-don't-know? It's the age old documentation problem coming back to bite us again :-S cheers, Chris -- Simplistix - Content Management, Zope & Python Consulting - http://www.simplistix.co.uk ___ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
