Re: need your help to overhaul docs

2012-02-22 Thread Jonathan Vanasco
Just wanted to add to this discussion , for potential things to address in the docs: The security authorization/authentication stuff is a bit intense. At first glance, it looks and reads very much like an enterprise software type of system, with a lot of overhead. If I were building a CMS or a

Re: need your help to overhaul docs

2012-02-22 Thread Michael Merickel
On Wed, Feb 22, 2012 at 11:31 AM, Jonathan Vanasco jonat...@findmeon.comwrote: 1. A nice paragraph or two giving an overview of the scope / style of Security that is offered , and why you might want to use it. ( even the first bit of

Re: need your help to overhaul docs

2012-02-22 Thread Benjamin Sims
Sorry, you mentioned your version of the docs in response to a similar comment that I made and I didn't reply. I did find your explanation very helpful in breaking down the explanations into digestible chunks - I'd very much support that yours should be merged into the main documents. Ben On 22

Re: need your help to overhaul docs

2012-02-14 Thread Wayne Witzel III
Put me down for $100. -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To view this discussion on the web visit https://groups.google.com/d/msg/pylons-discuss/-/E9pVh41uApAJ. To post to this group, send email to pylons-discuss@googlegroups.com.

Re: need your help to overhaul docs

2012-02-13 Thread Chris McDonough
On Fri, 2012-02-10 at 14:11 -0600, Joe Dallago wrote: Count me in for $25. I can give it to you at PyCon, if that is not too late. Otherwise, Paypal or something. Thanks! I have applied for a kickstarter.com project in the meantime. - C On Fri, Feb 10, 2012 at 12:36 PM, Iain Duncan

Re: need your help to overhaul docs

2012-02-13 Thread Tarek Ziadé
On 4 fév, 04:53, Chris McDonough chr...@plope.com wrote: ... So this is me asking you for money.  If I can find four other sponsors willing to contribute US $1000, I will contribute another $1000, making a total of $5000. Can you convince your company to donate US $1K to this effort?  The

Re: need your help to overhaul docs

2012-02-13 Thread artee
Hi I can contribute $50. Please add me to the list and tell us how send the money. Artur Lew -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To view this discussion on the web visit

Re: need your help to overhaul docs

2012-02-13 Thread Chris McDonough
On Mon, 2012-02-13 at 03:52 -0800, Tarek Ziadé wrote: On 4 fév, 04:53, Chris McDonough chr...@plope.com wrote: ... So this is me asking you for money. If I can find four other sponsors willing to contribute US $1000, I will contribute another $1000, making a total of $5000. Can you

Re: need your help to overhaul docs

2012-02-13 Thread Chris McDonough
On Mon, 2012-02-13 at 03:58 -0800, artee wrote: Hi I can contribute $50. Please add me to the list and tell us how send the money. Great, thank you! Still awaiting approval, but with any luck the money will eventually be collected via a kickstarter.com account. - C Artur Lew --

Re: need your help to overhaul docs

2012-02-13 Thread Iain Duncan
On Mon, Feb 13, 2012 at 3:52 AM, Tarek Ziadé ziade.ta...@gmail.com wrote: On 4 fév, 04:53, Chris McDonough chr...@plope.com wrote: ... So this is me asking you for money. If I can find four other sponsors willing to contribute US $1000, I will contribute another $1000, making a total

Re: need your help to overhaul docs

2012-02-11 Thread Chris McDonough
On Fri, 2012-02-10 at 10:36 -0800, Iain Duncan wrote: On Fri, Feb 10, 2012 at 10:26 AM, Chris McDonough chr...@plope.com wrote: On Fri, 2012-02-10 at 10:23 -0800, Iain Duncan wrote: The docs overhaul project isn't about a new website, it's just

Re: need your help to overhaul docs

2012-02-11 Thread Luciano Ramalho
On 4 fev, 01:53, Chris McDonough chr...@plope.com wrote: So this is me asking you for money.  If I can find four other sponsors willing to contribute US $1000, I will contribute another $1000, making a total of $5000. That is a great idea, Chris. I can contribute $100. Suggestion: set up a

Re: need your help to overhaul docs

2012-02-11 Thread Iain Duncan
that would be great Chris, thanks. http://docs.pylonsproject.org/en/latest/community/codestyle.html http://docs.pylonsproject.org/en/latest/community/addons-devenvs.html Thanks! Iain -- You received this message because you are subscribed to the Google Groups pylons-discuss group.

Re: need your help to overhaul docs

2012-02-11 Thread Iain Duncan
That is a great idea, Chris. I can contribute $100. Suggestion: set up a project on some crowdfunding site like http://www.fundageek.com/ and you'll have 5K real quick. +1 on that, kickstarter and it's ilk make it really easy to donate. iain -- You received this message because you are

Re: need your help to overhaul docs

2012-02-10 Thread Iain Duncan
Is there a plan to have a docs page about what's happening with the docs? (or wiki/trac/etc) I'd like to start documenting some of how we work with Pyramid and be able to integrate it better with the Real Docs. Thanks Iain -- You received this message because you are subscribed to the Google

Re: need your help to overhaul docs

2012-02-10 Thread Blaise Laflamme
You can start a page on the github pyramid wiki -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To view this discussion on the web visit https://groups.google.com/d/msg/pylons-discuss/-/35xtwwCxsMgJ. To post to this group, send email to

Re: need your help to overhaul docs

2012-02-10 Thread Iain Duncan
On Fri, Feb 10, 2012 at 9:57 AM, Blaise Laflamme bla...@laflamme.orgwrote: You can start a page on the github pyramid wiki What I mean was to ask whether Graham et al would be putting up a roadmap somewhere of their reorg so I can slant my efforts accordingly. Thanks Iain -- You received

Re: need your help to overhaul docs

2012-02-10 Thread Arndt Droullier
Am Freitag, den 10.02.2012, 09:57 -0800 schrieb Blaise Laflamme: You can start a page on the github pyramid wiki BTW, will the new website also include user accounts to publish How Tos or pyramid extensions? Especially a central list of pyramid extensions was useful. Arndt. -- You

Re: need your help to overhaul docs

2012-02-10 Thread Chris McDonough
On Fri, 2012-02-10 at 19:13 +0100, Arndt Droullier wrote: Am Freitag, den 10.02.2012, 09:57 -0800 schrieb Blaise Laflamme: You can start a page on the github pyramid wiki BTW, will the new website also include user accounts to publish How Tos or pyramid extensions? Especially a central

Re: need your help to overhaul docs

2012-02-10 Thread Iain Duncan
The docs overhaul project isn't about a new website, it's just about overhauling the existing narrative and API docs. Currently the Cookbook is where to put howtos (you can fork it and add new howtos via https://github.com/Pylons/pyramid_cookbook). You can create Pyramid extensions and

Re: need your help to overhaul docs

2012-02-10 Thread Chris McDonough
On Fri, 2012-02-10 at 10:23 -0800, Iain Duncan wrote: The docs overhaul project isn't about a new website, it's just about overhauling the existing narrative and API docs. Currently the Cookbook is where to put howtos (you can fork it and add

Re: need your help to overhaul docs

2012-02-10 Thread Iain Duncan
On Fri, Feb 10, 2012 at 10:26 AM, Chris McDonough chr...@plope.com wrote: On Fri, 2012-02-10 at 10:23 -0800, Iain Duncan wrote: The docs overhaul project isn't about a new website, it's just about overhauling the existing narrative and API docs.

Re: need your help to overhaul docs

2012-02-10 Thread Joe Dallago
Count me in for $25. I can give it to you at PyCon, if that is not too late. Otherwise, Paypal or something. On Fri, Feb 10, 2012 at 12:36 PM, Iain Duncan iainduncanli...@gmail.com wrote: On Fri, Feb 10, 2012 at 10:26 AM, Chris McDonough chr...@plope.com wrote: On Fri, 2012-02-10 at 10:23

Re: need your help to overhaul docs

2012-02-10 Thread Mike Orr
On Fri, Feb 10, 2012 at 9:57 AM, Blaise Laflamme bla...@laflamme.org wrote: You can start a page on the github pyramid wiki I started a page for the documentation roadmap and user suggestions. https://github.com/Pylons/pyramid/wiki/Documentation-Roadmap -- Mike Orr sluggos...@gmail.com --

Re: need your help to overhaul docs

2012-02-10 Thread Chris McDonough
On Fri, 2012-02-10 at 13:12 -0800, Mike Orr wrote: On Fri, Feb 10, 2012 at 9:57 AM, Blaise Laflamme bla...@laflamme.org wrote: You can start a page on the github pyramid wiki I started a page for the documentation roadmap and user suggestions.

Re: need your help to overhaul docs

2012-02-09 Thread Bruce Coble
You can count me in for another $50... Bruce -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To view this discussion on the web visit https://groups.google.com/d/msg/pylons-discuss/-/x5nfcGchdj8J. To post to this group, send email to

Re: need your help to overhaul docs

2012-02-09 Thread Chris McDonough
On Thu, 2012-02-09 at 16:35 -0800, Bruce Coble wrote: You can count me in for another $50... Thanks! Bruce -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To view this discussion on the web visit

Re: need your help to overhaul docs

2012-02-08 Thread Iain Duncan
I'll observe that's a straw man that you've brought to the party; no-one has mentioned any trimming of the docs, simplistically or otherwise. ??? From the originating post by Chris - Trim down the current set of docs to a more manageable length. Currently they weigh in at over 700 printed

Re: need your help to overhaul docs

2012-02-08 Thread Iain Duncan
On Mon, Feb 6, 2012 at 12:02 PM, Mike Orr sluggos...@gmail.com wrote: +1 for splitting the manual into simple and advanced, however that's defined. Simple = normal application usage based on the built-in scaffolds. This would include both Chameleon and Mako, and maybe traversal. Advanced =

Re: need your help to overhaul docs

2012-02-08 Thread Chris McDonough
On Wed, 2012-02-08 at 09:44 -0800, Iain Duncan wrote: On Mon, Feb 6, 2012 at 12:02 PM, Mike Orr sluggos...@gmail.com wrote: +1 for splitting the manual into simple and advanced, however that's defined. Simple = normal application usage based on the

Re: need your help to overhaul docs

2012-02-08 Thread Mike Orr
On Wed, Feb 8, 2012 at 9:56 AM, Chris McDonough chr...@plope.com wrote: Pyramid's use of a ZCA registry is still an internal implementation detail, and as such isn't really intentionally exposed to the outside world.  It won't make much sense for the docs to explain how Pyramid works in terms

Re: need your help to overhaul docs

2012-02-08 Thread Graham Higgins
On Wednesday, 8 February 2012 17:35:50 UTC, Iain Duncan wrote: I'll observe that's a straw man that you've brought to the party; no-one has mentioned any trimming of the docs, simplistically or otherwise. That seems like a pretty clear mention of trimming the docs to get rid of the

Re: need your help to overhaul docs

2012-02-08 Thread Iain Duncan
Pyramid's use of a ZCA registry is still an internal implementation detail, and as such isn't really intentionally exposed to the outside world. It won't make much sense for the docs to explain how Pyramid works in terms of ZCA vocabulary such as adaptation, or even link heavily to things

Re: need your help to overhaul docs

2012-02-08 Thread Iain Duncan
Configurator methods to call, just as the docs do now. Theoretically, Pyramid may disuse the ZCA in a future major release (although it's highly unlikely). It might also be worth mentioning that dis-using the ZCA would end a lot of my work for our system, and force us to either stay on a

Re: need your help to overhaul docs

2012-02-08 Thread Michael Merickel
This was just a documentation emphasis... Pyramid won't be getting rid of the component registry without a damn good reason. On Wed, Feb 8, 2012 at 5:33 PM, Iain Duncan iainduncanli...@gmail.comwrote: Configurator methods to call, just as the docs do now. Theoretically, Pyramid may disuse

Re: need your help to overhaul docs

2012-02-08 Thread Chris McDonough
On Wed, 2012-02-08 at 17:51 -0600, Michael Merickel wrote: This was just a documentation emphasis... Pyramid won't be getting rid of the component registry without a damn good reason. On Wed, Feb 8, 2012 at 5:33 PM, Iain Duncan iainduncanli...@gmail.com wrote:

Re: need your help to overhaul docs

2012-02-07 Thread Danny Navarro
I'll contribute with € 50, too. -- Danny Navarro | http://blog.dannynavarro.net On Tue, Feb 7, 2012 at 8:07 AM, Robert Forkel xrotw...@googlemail.com wrote: i'd be happy to chip in € 50 = 65.47500 U.S. dollars best regards robert On Sat, Feb 4, 2012 at 4:53 AM, Chris McDonough

Re: need your help to overhaul docs

2012-02-07 Thread Chris McDonough
On Tue, 2012-02-07 at 10:31 +0100, Danny Navarro wrote: I'll contribute with € 50, too. -- Danny Navarro | http://blog.dannynavarro.net On Tue, Feb 7, 2012 at 8:07 AM, Robert Forkel xrotw...@googlemail.com wrote: i'd be happy to chip in € 50 = 65.47500 U.S. dollars best regards

Re: need your help to overhaul docs

2012-02-07 Thread Mark Gemmill
Personally, the only real shortcoming I've found with Pyramid (documentation or otherwise) is that it doesn't have a Buy that man a beer! button. :-) So, count me in for $50 to help out. Mark -- You received this message because you are subscribed to the Google Groups pylons-discuss group.

Re: need your help to overhaul docs

2012-02-06 Thread Matt Feifarek
On Fri, Feb 3, 2012 at 9:53 PM, Chris McDonough chr...@plope.com wrote: Can you convince your company to donate US $1K to this effort? The money would be collected by Agendaless and transfered to Graham as soon as we reached our goal. I'm an indie, so no, but I can personally pledge $100,

Re: need your help to overhaul docs

2012-02-06 Thread Chris McDonough
On Mon, 2012-02-06 at 10:46 -0600, Matt Feifarek wrote: On Fri, Feb 3, 2012 at 9:53 PM, Chris McDonough chr...@plope.com wrote: Can you convince your company to donate US $1K to this effort? The money would be collected by Agendaless and transfered to Graham

Re: need your help to overhaul docs

2012-02-06 Thread Iain Duncan
We're indy too but could kick in $50. That said, please do not just trim the expert oriented stuff and have it nowhere, that will seriously lower the quality of the docs for complex applications and people weighing up pyramid for those kinds of purposes. You'll just be hiding lots of the best

Re: need your help to overhaul docs

2012-02-06 Thread Graham Higgins
On Monday, 6 February 2012 17:54:36 UTC, Iain Duncan wrote: but simply trimming the docs I'll observe that's a straw man that you've brought to the party; no-one has mentioned any trimming of the docs, simplistically or otherwise. My personal preference would be to have a parallel structure

Re: need your help to overhaul docs

2012-02-06 Thread Graham Higgins
Iain, apologies, my response was overly stiff and formal, it wasn't meant to be - you got some unintended crosstalk from a parallel conv that I was in, soz. Really, Heartfelt thanks for the contribution was what I should have written. I'll try and explain my thinking later, we need a Plan B

Re: need your help to overhaul docs

2012-02-06 Thread Mike Orr
+1 for splitting the manual into simple and advanced, however that's defined. Simple = normal application usage based on the built-in scaffolds. This would include both Chameleon and Mako, and maybe traversal. Advanced = optional customizations such as new renderers or ZCA. The hardest things to

Re: need your help to overhaul docs

2012-02-06 Thread Tjelvar
I'm just a casual user, but I could contribute £30 (~$47), if this is not too little. On a related note I'd quite like to see a more mainstream book on Pyramid. So for my own edification I'm in the process of trying to write one. Does anyone else feel that there is a need for such a book or is it

Re: need your help to overhaul docs

2012-02-06 Thread Chris McDonough
On Mon, 2012-02-06 at 22:11 -0800, Tjelvar wrote: I'm just a casual user, but I could contribute £30 (~$47), if this is not too little. Thanks, it's great. On a related note I'd quite like to see a more mainstream book on Pyramid. So for my own edification I'm in the process of trying to

Re: need your help to overhaul docs

2012-02-05 Thread Simon Yarde
I would be happy to personally contribute $50 to the effort. Please add me to the list. Perhaps this is an amount other independents could put forward, and together another 18 of us might represent one of the $1000 company contributions? Best, S On 4 Feb 2012, at 12:32, Chris McDonough wrote:

Re: need your help to overhaul docs

2012-02-05 Thread Chris McDonough
On Sun, 2012-02-05 at 10:11 +, Simon Yarde wrote: I would be happy to personally contribute $50 to the effort. Please add me to the list. Perhaps this is an amount other independents could put forward, and together another 18 of us might represent one of the $1000 company

Re: need your help to overhaul docs

2012-02-05 Thread Wyatt Baldwin
I'll commit to $100. -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To view this discussion on the web visit https://groups.google.com/d/msg/pylons-discuss/-/Ct3kw0v6GfIJ. To post to this group, send email to pylons-discuss@googlegroups.com.

Re: need your help to overhaul docs

2012-02-05 Thread Chris McDonough
On Sun, 2012-02-05 at 11:37 -0800, Wyatt Baldwin wrote: I'll commit to $100. Much appreciated! -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To view this discussion on the web visit

Re: need your help to overhaul docs

2012-02-05 Thread clemensherschel
I will contribute $100. Thanks. On 2/4/2012 6:08 AM, Ginés Martínez wrote: I will contribute with 50 €. Tell us how send the money. Gins. -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To post to this group, send email to

Re: need your help to overhaul docs

2012-02-05 Thread Chris McDonough
On Sun, 2012-02-05 at 15:02 -0500, clemensherschel wrote: I will contribute $100. Thanks. Many thanks, I'll mark it down. On 2/4/2012 6:08 AM, Ginés Martínez wrote: I will contribute with 50 €. Tell us how send the money. Gins. -- You received this message because you are subscribed

Re: need your help to overhaul docs

2012-02-05 Thread Cem Ikta
I will contribute with 100 €. We need good docs for everyone. Best regards. Cem. -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To view this discussion on the web visit https://groups.google.com/d/msg/pylons-discuss/-/JpF5Qlibe38J. To post

Re: need your help to overhaul docs

2012-02-05 Thread Chris McDonough
On Sun, 2012-02-05 at 16:23 -0800, Cem Ikta wrote: I will contribute with 100 €. We need good docs for everyone. Great! Best regards. Cem. -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To view this discussion on the web visit

Re: need your help to overhaul docs

2012-02-04 Thread Ginés Martínez
I will contribute with 50 €. Tell us how send the money. Gins. -- You received this message because you are subscribed to the Google Groups pylons-discuss group. To post to this group, send email to pylons-discuss@googlegroups.com. To unsubscribe from this group, send email to

Re: need your help to overhaul docs

2012-02-04 Thread Chris McDonough
On Sat, 2012-02-04 at 12:08 +0100, Ginés Martínez wrote: I will contribute with 50 €. Tell us how send the money. Thank you! I'll mark you down for that amount and if we reach the goal we'll arrange for payment (it will probably be via Paypal). - C -- You received this message because you

Re: need your help to overhaul docs

2012-02-04 Thread John Anderson
I'm busy until PyCon is over but I will donate 40hrs of my time helping rewrite docs, blog posts, screencasts, or whatever is needed the week after PyCon On Feb 4, 2012 12:14 PM, Jonathan Vanasco jonat...@findmeon.com wrote: kickstarter? -- You received this message because you are subscribed

need your help to overhaul docs

2012-02-03 Thread Chris McDonough
While Pyramid will never be as high-level as something like Plone or Django or Rails, it's still often more appropriate to use than those systems in a variety of situations, not all of which require complete Python mastery. We can do a much better job on docs for intermediate Python developers.

Re: need your help to overhaul docs

2012-02-03 Thread Mike Orr
By the way, I'm planning some organization work on the Cookbook after I finish the Pyramid/Pylons guide. I want to organize the main page into topic chapters (database, forms, templates, deployment, etc), put large items into subpages under their topic, and write stub pages for the topics that

Re: need your help to overhaul docs

2012-02-03 Thread Chris McDonough
On Fri, 2012-02-03 at 20:26 -0800, Mike Orr wrote: By the way, I'm planning some organization work on the Cookbook after I finish the Pyramid/Pylons guide. I want to organize the main page into topic chapters (database, forms, templates, deployment, etc), put large items into subpages under

Re: need your help to overhaul docs

2012-02-03 Thread Steve Piercy
I'd like to donate labor to the effort by proofreading and providing a Pyramid/Python newbie perspective. --steve On 2/3/12 at 10:53 PM, chr...@plope.com (Chris McDonough) pronounced: While Pyramid will never be as high-level as something like Plone or Django or Rails, it's still often more