Re: [Zope-dev] zope3docs - zopeframework?
Jens Vagelpohl wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Mar 5, 2009, at 08:24 , Christian Theune wrote: As Dan pointed out, some of those documents are a bit more general than Zope Framework, but, then again, they're also more general than Zope 3. So even for that its better to have them in the Zope Framework area than Zope 3. Before anything is moved around please be aware that the zope3docs repository folder is used to rebuild http://docs.zope.org/zope3docs/ on a daily basis. So make sure you don't completely break it since the URL is now known, indexed and used. Thanks for pointing that out. If we moved it could you put a redirect in place that just pointed .../zope3docs to .../zopeframework? I think to get started on the move we could copy the information using svn copy instead of svn move it, so that we don't break the URL until we're ready updating the texts. Regards, Martijn ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework?
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Mar 5, 2009, at 16:32 , Martijn Faassen wrote: Thanks for pointing that out. If we moved it could you put a redirect in place that just pointed .../zope3docs to .../zopeframework? I think to get started on the move we could copy the information using svn copy instead of svn move it, so that we don't break the URL until we're ready updating the texts. Let's do this: - svn copy zope3docs to zopeframework - once you think zopeframework is ready for public viewing, let me know and I'll set up a self-updating sandbox and a redirect - after all that you can safely delete zope3docs in SVN. jens -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.8 (Darwin) iEYEARECAAYFAkmwCswACgkQRAx5nvEhZLIw7wCfYdIyMeo1Bdr0Z96oxzKutrh8 DM0An0bVZyVT0T7C7aXwcD71AQOx0/kv =1wTg -END PGP SIGNATURE- ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework?
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Mar 5, 2009, at 18:24 , Jens Vagelpohl wrote: Let's do this: - svn copy zope3docs to zopeframework - once you think zopeframework is ready for public viewing, let me know and I'll set up a self-updating sandbox and a redirect - after all that you can safely delete zope3docs in SVN. Just saw your other message, I'll set everything up and answer the other thread then. jens -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.8 (Darwin) iEYEARECAAYFAkmwC3sACgkQRAx5nvEhZLKVqwCeIRgkDTOTAKJVbNTuA/25e9gx pnUAn3WMB/jp0pa06UqwYfAHwxZxznKs =mzhb -END PGP SIGNATURE- ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Mar 5, 2009, at 17:55 , Martijn Faassen wrote: Jens, could you pick up zopeframework/trunk now for http://docs.zope.org/zopeframework? And put a redirect in place for http://docs.zope.org/zope3docs to the new location? We can then retire zope3docs. All done. jens -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.8 (Darwin) iEYEARECAAYFAkmwDacACgkQRAx5nvEhZLLqUACcCkhlCDTlnMNufD3wbKoRH+TU nW8AniiZCJUhQJC6DI+d9Bxwu/h7jHE1 =j7VO -END PGP SIGNATURE- ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework
Hey, Jens Vagelpohl wrote: On Mar 5, 2009, at 17:55 , Martijn Faassen wrote: Jens, could you pick up zopeframework/trunk now for http://docs.zope.org/zopeframework? And put a redirect in place for http://docs.zope.org/zope3docs to the new location? We can then retire zope3docs. All done. Great, thanks Jens! I've just completed adding some bits and pieces to this documentation from the document I previously posted. How often does this get regenerated? Anyway, I expect the SVN changes will show up by tomorrow. :) Regards, Martijn ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework
Jens Vagelpohl wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Mar 5, 2009, at 17:55 , Martijn Faassen wrote: Jens, could you pick up zopeframework/trunk now for http://docs.zope.org/zopeframework? And put a redirect in place for http://docs.zope.org/zope3docs to the new location? We can then retire zope3docs. All done. I've just retired zope3docs and left a README.txt in place to avoid confusion. Regards, Martijn ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Mar 5, 2009, at 19:08 , Martijn Faassen wrote: Hey, Jens Vagelpohl wrote: On Mar 5, 2009, at 17:55 , Martijn Faassen wrote: Jens, could you pick up zopeframework/trunk now for http://docs.zope.org/zopeframework? And put a redirect in place for http://docs.zope.org/zope3docs to the new location? We can then retire zope3docs. All done. Great, thanks Jens! I've just completed adding some bits and pieces to this documentation from the document I previously posted. How often does this get regenerated? Anyway, I expect the SVN changes will show up by tomorrow. :) I just did a manual regeneration. The automatic build happens once a day around 7AM Eastern time. jens -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.8 (Darwin) iEYEARECAAYFAkmwHDEACgkQRAx5nvEhZLK4cgCfXwOIJk2u1tIeXinSAX3SDoMO mEQAmwWpbbUcMPUffU+RmRuC+6SrAeMo =UA/e -END PGP SIGNATURE- ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework?
2009/3/4 Martijn Faassen faas...@startifact.com: Hi there, We have an area called 'zope3docs': http://svn.zope.org/zope3docs/ which contains many documents that are actually more about the Zope Framework than the Zope 3 app server. In fact I suspect all of these documents are more about the framework than anything else, so we should move them all over. http://svn.zope.org/zopeframework/trunk/ Opinions? Well, that docs are currently not necessarily about the zope framework (as far as I understood what's zope framework now), but more about general development guidelines applied to any package in zope svn (except the migration section, maybe), but I personally don't have any objections, as it's still easy to find those docs and that's the most important. :-) -- WBR, Dan Korostelev ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework?
Hi there, On Wed, Mar 4, 2009 at 8:05 PM, Dan Korostelev nad...@gmail.com wrote: [snip Well, that docs are currently not necessarily about the zope framework (as far as I understood what's zope framework now), but more about general development guidelines applied to any package in zope svn (except the migration section, maybe), but I personally don't have any objections, as it's still easy to find those docs and that's the most important. :-) I think following the Zope Framework model we should make these documents just apply to the source files in the Zope Framework, and let them serve as an example for other files. There's nobody who can *enforce* compliance though. Besides, lots of those guidelines won't apply to Zope 2 code anyway as far as I know. Well, there is a group that could force compliance for the entire repository, and that's the Zope Foundation (soon), but they care only about a few basic things. Regards, Martijn ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework?
On Wed, 2009-03-04 at 20:50 +0100, Martijn Faassen wrote: Hi there, On Wed, Mar 4, 2009 at 8:05 PM, Dan Korostelev nad...@gmail.com wrote: [snip Well, that docs are currently not necessarily about the zope framework (as far as I understood what's zope framework now), but more about general development guidelines applied to any package in zope svn (except the migration section, maybe), but I personally don't have any objections, as it's still easy to find those docs and that's the most important. :-) I think following the Zope Framework model we should make these documents just apply to the source files in the Zope Framework, and let them serve as an example for other files. There's nobody who can *enforce* compliance though. Besides, lots of those guidelines won't apply to Zope 2 code anyway as far as I know. Well, there is a group that could force compliance for the entire repository, and that's the Zope Foundation (soon), but they care only about a few basic things. When I started putting in those documents I named it zope3docs initially although I suspected that they would apply to what now became the Zope Framework. The migration document would ne a slight revamp though, as we don't have Zope Framework releases, yet. As Dan pointed out, some of those documents are a bit more general than Zope Framework, but, then again, they're also more general than Zope 3. So even for that its better to have them in the Zope Framework area than Zope 3. Christian -- Christian Theune · c...@gocept.com gocept gmbh co. kg · forsterstraße 29 · 06112 halle (saale) · germany http://gocept.com · tel +49 345 1229889 7 · fax +49 345 1229889 1 Zope and Plone consulting and development signature.asc Description: This is a digitally signed message part ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs - zopeframework?
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Mar 5, 2009, at 08:24 , Christian Theune wrote: As Dan pointed out, some of those documents are a bit more general than Zope Framework, but, then again, they're also more general than Zope 3. So even for that its better to have them in the Zope Framework area than Zope 3. Before anything is moved around please be aware that the zope3docs repository folder is used to rebuild http://docs.zope.org/zope3docs/ on a daily basis. So make sure you don't completely break it since the URL is now known, indexed and used. jens -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.8 (Darwin) iEYEARECAAYFAkmvg4wACgkQRAx5nvEhZLK0sgCeKvPJRd6OSzBpGY7SV1470yFq cF8AnR1ZFLTQdMdJpB36RJK+qgcL5hMG =dDsp -END PGP SIGNATURE- ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs
Christian Theune a écrit : On Mon, 2 Feb 2009 09:16:38 -0800 Paul Carduner paulcardu...@gmail.com wrote: On Mon, Feb 2, 2009 at 8:49 AM, Christian Theune c...@gocept.com wrote: My short-term goal is to produce a document that I can pass to new developers with reasonable confidence that they know roughly how to move in our community. In the long term I'd also like to incorporate documentation about Zope 3 components themselve there. Awesome! I'd be happy to get feedback on this and I'll probably come up with some questions if I can't find an answer in the existing documents. I'll ask the question of why not put this on the new.zope.org website? .oO(Geez, we're bad at communicating internally ...) new.zope.org does not exist anymore. The project was cancelled a while ago. We can not use that layout. there is not much design apart from the css, and a few illustrations. I've contributed some textual contents on this site, the folder arrangement, the get-started page, a few tutorials in the Example folder. You can retrieve everything and move it to the svn as rst files. I think we can keep the same kind of folder layout (Get Started, Projects with z2, z3 app, z3 library, zodb, etc.). Since the new site is not intended to be a collaborative space, we really don't need a Plone for that. A Sphinx is ideal. Christophe .oO(Hopefully the communication about this that ended up in my brain was correct) Nevertheless, you're right about the ease of writing ReST in my own editor. Christian ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs
On Mon, Feb 2, 2009 at 11:49 AM, Christian Theune c...@gocept.com wrote: I've created a project in SVN labelled zope3docs and thought I'd let you know what I intend to start doing there. My short-term goal is to produce a document that I can pass to new developers with reasonable confidence that they know roughly how to move in our community. A hearty +1 from me. I have very little time to spend, but I'm sure I'll at least read what you produce in hopes of helping how I can. -- Benji York Senior Software Engineer Zope Corporation ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs
On Mon, Feb 2, 2009 at 8:49 AM, Christian Theune c...@gocept.com wrote: My short-term goal is to produce a document that I can pass to new developers with reasonable confidence that they know roughly how to move in our community. In the long term I'd also like to incorporate documentation about Zope 3 components themselve there. Awesome! I'd be happy to get feedback on this and I'll probably come up with some questions if I can't find an answer in the existing documents. I'll ask the question of why not put this on the new.zope.org website? I think the obvious response is that it's easier to write docs in rst format and stick it in subversion than to write it out on the plone site where people don't get change notifications, etc. That said, it would be nice if these docs could somehow magically appear on the plone site (I'm told plone has some product for syncing content from subversion?). Alternatively, we could just generate the docs from the rst files but use the sphinx template I made in z3c.recipe.sphinxdoc that looks just like the plone site. Hopefully there is something I can contribute to these docs, but it looks like you've got a pretty good start on them. -- Paul Carduner http://www.carduner.net ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs
On Mon, 2 Feb 2009 09:16:38 -0800 Paul Carduner paulcardu...@gmail.com wrote: On Mon, Feb 2, 2009 at 8:49 AM, Christian Theune c...@gocept.com wrote: My short-term goal is to produce a document that I can pass to new developers with reasonable confidence that they know roughly how to move in our community. In the long term I'd also like to incorporate documentation about Zope 3 components themselve there. Awesome! I'd be happy to get feedback on this and I'll probably come up with some questions if I can't find an answer in the existing documents. I'll ask the question of why not put this on the new.zope.org website? .oO(Geez, we're bad at communicating internally ...) new.zope.org does not exist anymore. The project was cancelled a while ago. We can not use that layout. .oO(Hopefully the communication about this that ended up in my brain was correct) Nevertheless, you're right about the ease of writing ReST in my own editor. Christian -- Christian Theune · c...@gocept.com gocept gmbh co. kg · forsterstraße 29 · 06112 halle (saale) · germany http://gocept.com · tel +49 345 1229889 0 · fax +49 345 1229889 1 Zope and Plone consulting and development ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Feb 2, 2009, at 18:32 , Christian Theune wrote: Nevertheless, you're right about the ease of writing ReST in my own editor. What's even better: SVN-based documentation (or buildouts that create it) can be automated so that the site can be refreshed without human intervention. FYI: A while ago I created the http://docs.zope.org/ as a possible central address for collecting generated Zope documentation. jens -BEGIN PGP SIGNATURE- Version: GnuPG v1.4.8 (Darwin) iEYEARECAAYFAkmHMvUACgkQRAx5nvEhZLIBsACePznehn/NTrIhuQb6lEd2c+my geoAnRr5Q5qhcJymcGippg5cYjJmtAXR =iT5g -END PGP SIGNATURE- ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
Re: [Zope-dev] zope3docs
On Mon, 02 Feb 2009 09:16:38 -0800, Paul Carduner wrote: it would be nice if these docs could somehow magically appear on the plone site (I'm told plone has some product for syncing content from subversion?). http://dev.plone.org/collective/browser/FSReST ___ Zope-Dev maillist - Zope-Dev@zope.org http://mail.zope.org/mailman/listinfo/zope-dev ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope )
