Re: [Zope3-Users] Re: Zope 3.1.0 & Zope3 Developer's Book
On Thursday 23 June 2005 04:19 am, Stephan Richter wrote: > On Saturday 18 June 2005 16:08, Corey wrote: > > Maybe I can be of some help by going through the book using the new 3.1b > > and make notes of whatever stuff ( code and/or text ) that could be > > changed to better reflect the changes from 3.0 to 3.1. > > That would be great! The first task would be though to merge the SAMS edit > work to the master TeX document. I can provide you with the Word files from > SAMS and give you access to the book repository, which is located in a > special repository on zope.org. > Sounds great; I'll be able to devote real, actual, time to this. I went and emailed Jim a signed and scanned copy of the Contributor Agreement, so hopefully I'll be recieving an svn account soon. Cheers, Corey ___ Zope3-users mailing list Zope3-users@zope.org http://mail.zope.org/mailman/listinfo/zope3-users
Re: [Zope3-Users] Re: Zope 3.1.0 & Zope3 Developer's Book
On Saturday 18 June 2005 16:08, Corey wrote: > Maybe I can be of some help by going through the book using the new 3.1b > and make notes of whatever stuff ( code and/or text ) that could be changed > to better reflect the changes from 3.0 to 3.1. That would be great! The first task would be though to merge the SAMS edit work to the master TeX document. I can provide you with the Word files from SAMS and give you access to the book repository, which is located in a special repository on zope.org. > Or maybe if the Zope3 Book was wiki'fied, like the Zope2 Book > ( http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition/ ), it would > be easier for others to contribute change suggestions and report > issues/discrepancies. Not with my support! :-) Wikis/ReST suck when it comes to professional publishable writing, since you can not (a) insert meta-data, such as indexes, and (b) define styles easily as it is desired. I orginially had the book in StructuredText. But eventually the frustration grew too high and I created this solution, which is much better. Note that the TeX sources have all the scripts in place to generate HTML and PDF and upload the files to zope.org. Regards, Stephan -- Stephan Richter CBU Physics & Chemistry (B.S.) / Tufts Physics (Ph.D. student) Web2k - Web Software Design, Development and Training ___ Zope3-users mailing list Zope3-users@zope.org http://mail.zope.org/mailman/listinfo/zope3-users
Re: [Zope3-Users] Re: Zope 3.1.0 & Zope3 Developer's Book
On 6/18/05, Stephan Richter <[EMAIL PROTECTED]> wrote: > On Saturday 18 June 2005 15:19, Corey wrote: > > Question: with all these new changes since 3.0 ( which all look very good! > > ), approximately how much of the Zope3 Dev Book becomes > > misleading/incorrect/obsolete? Primarily I'm wondering whether it is still > > possible to use the Zope3 dev book , follow along with it's > > examples/excersises without constantly running into troubles? > > Yeah, I think that most of it will still work just fine. I think someone > reported that step 7 or 8 of the messageboard product was still working on > the trunk, which is impressive. Before the final release I will take some > time and make sure that all the packages will still work without > modification. > > > Right off the bat, I can see that the stuff on Services will be a point of > > hassle and confusion for many people starting off w/ Zope 3.1 and the > > current Zope3 dev guide. > > Right, this cannot be avoided. But I already talk very little about services > in the book. > > > Are there prospective plans to keep the book updated with the releases, or > > are there simply not enough resources/time available at this point to do > > so? > > I am not sure how much time I will have. I am very booked till school starts > again. I would need at least a week to get everything updated, not to mention > covering new features. > > Regards, > Stephan > -- > Stephan Richter > CBU Physics & Chemistry (B.S.) / Tufts Physics (Ph.D. student) > Web2k - Web Software Design, Development and Training > ___ > Zope3-users mailing list > Zope3-users@zope.org > http://mail.zope.org/mailman/listinfo/zope3-users > I would be very interested in attempting to provide an update to the book, to cover new features in 3.1. I still have a lot to learn, but I thought that perhaps it would be helpful to pick a section in the book that has changed (for example, I believe Chapter 20, on workflow), and attempt to document the appropriate way to handle it in 3.1. As I said, I do have a lot to learn, but as long as someone points me in the right direction, I would feel comfortable attempting this. Is this something that would be helpful? Alec ___ Zope3-users mailing list Zope3-users@zope.org http://mail.zope.org/mailman/listinfo/zope3-users
Re: [Zope3-Users] Re: Zope 3.1.0 & Zope3 Developer's Book
On Saturday 18 June 2005 01:08 pm, Corey wrote: > Does the online Zope3 reflect the dead-tree version? > Ack, my bad - looks like this is stated to not be the case right there on the front page, sorry! http://www.zope.org/Wikis/DevSite/Projects/ComponentArchitecture/FrontPage/Zope3Book "It also has not been edited based on Sams comments and editions. " Appologies for the noise! ___ Zope3-users mailing list Zope3-users@zope.org http://mail.zope.org/mailman/listinfo/zope3-users
Re: [Zope3-Users] Re: Zope 3.1.0 & Zope3 Developer's Book
Thanks for the response, Stephan; your efforts are appreciated! Maybe I can be of some help by going through the book using the new 3.1b and make notes of whatever stuff ( code and/or text ) that could be changed to better reflect the changes from 3.0 to 3.1. Or maybe if the Zope3 Book was wiki'fied, like the Zope2 Book ( http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition/ ), it would be easier for others to contribute change suggestions and report issues/discrepancies. Does the online Zope3 reflect the dead-tree version? On Saturday 18 June 2005 12:32 pm, Stephan Richter wrote: > On Saturday 18 June 2005 15:19, Corey wrote: > > Question: with all these new changes since 3.0 ( which all look very > > good! ), approximately how much of the Zope3 Dev Book becomes > > misleading/incorrect/obsolete? Primarily I'm wondering whether it is > > still possible to use the Zope3 dev book , follow along with it's > > examples/excersises without constantly running into troubles? > > Yeah, I think that most of it will still work just fine. I think someone > reported that step 7 or 8 of the messageboard product was still working on > the trunk, which is impressive. Before the final release I will take some > time and make sure that all the packages will still work without > modification. > > > Right off the bat, I can see that the stuff on Services will be a point > > of hassle and confusion for many people starting off w/ Zope 3.1 and the > > current Zope3 dev guide. > > Right, this cannot be avoided. But I already talk very little about > services in the book. > > > Are there prospective plans to keep the book updated with the releases, > > or are there simply not enough resources/time available at this point to > > do so? > > I am not sure how much time I will have. I am very booked till school > starts again. I would need at least a week to get everything updated, not > to mention covering new features. > > Regards, > Stephan ___ Zope3-users mailing list Zope3-users@zope.org http://mail.zope.org/mailman/listinfo/zope3-users
Re: [Zope3-Users] Re: Zope 3.1.0 & Zope3 Developer's Book
On Saturday 18 June 2005 15:19, Corey wrote: > Question: with all these new changes since 3.0 ( which all look very good! > ), approximately how much of the Zope3 Dev Book becomes > misleading/incorrect/obsolete? Primarily I'm wondering whether it is still > possible to use the Zope3 dev book , follow along with it's > examples/excersises without constantly running into troubles? Yeah, I think that most of it will still work just fine. I think someone reported that step 7 or 8 of the messageboard product was still working on the trunk, which is impressive. Before the final release I will take some time and make sure that all the packages will still work without modification. > Right off the bat, I can see that the stuff on Services will be a point of > hassle and confusion for many people starting off w/ Zope 3.1 and the > current Zope3 dev guide. Right, this cannot be avoided. But I already talk very little about services in the book. > Are there prospective plans to keep the book updated with the releases, or > are there simply not enough resources/time available at this point to do > so? I am not sure how much time I will have. I am very booked till school starts again. I would need at least a week to get everything updated, not to mention covering new features. Regards, Stephan -- Stephan Richter CBU Physics & Chemistry (B.S.) / Tufts Physics (Ph.D. student) Web2k - Web Software Design, Development and Training ___ Zope3-users mailing list Zope3-users@zope.org http://mail.zope.org/mailman/listinfo/zope3-users
[Zope3-Users] Re: Zope 3.1.0 & Zope3 Developer's Book
On Saturday 18 June 2005 11:50 am, Stephan Richter wrote: > Most Important Changes Since 3.0 Question: with all these new changes since 3.0 ( which all look very good! ), approximately how much of the Zope3 Dev Book becomes misleading/incorrect/obsolete? Primarily I'm wondering whether it is still possible to use the Zope3 dev book , follow along with it's examples/excersises without constantly running into troubles? Right off the bat, I can see that the stuff on Services will be a point of hassle and confusion for many people starting off w/ Zope 3.1 and the current Zope3 dev guide. Are there prospective plans to keep the book updated with the releases, or are there simply not enough resources/time available at this point to do so? Many thanks! ( not trying to be a squeeky wheel, just curious ) Cheers, Corey ___ Zope3-users mailing list Zope3-users@zope.org http://mail.zope.org/mailman/listinfo/zope3-users
