Ches, On Wed, Nov 28, 2007 at 11:37:44AM -0800, Ches Martin wrote: > Just wanted to share for public consumption that I've created a page > in the Cookbook section of the wiki for suggested documentation fixes/ > suggestions: > > http://wiki.pylonshq.com/display/pylonscookbook/Suggested+Improvements+to+the+Documentation
Very good. The documentation has improved a lot in the last year but still too chaotic IMHO. > It pretty much entirely consists of my own brainstorming at this > point, and things I've heard other users speak up about. So contribute > your own as you see fit -- it's a wiki after all -- and complain about > my ideas if you wish. The guidelines on the page are pretty succinct, > but I'll ask again that you relegate discussion to this list or the > IRC channel -- maintaining the wiki page may be troublesome enough, > running commentary there would just get unwieldy. Maybe we'll rally > some fervor for that doc sprint pjenvey's been hinting at for awhile. Allow me to comment here instead of commenting on the wiki. Concepts of Pylons -> Beginning Pylons ------------------------------------------ I know that my article is pretty ancient already. A while ago I started rewriting it and added a extensive tutorial to it. I hoped to surprise you all with a great writeup but then I stopped working on it because it was a lot of work and Pylons started changing metaphors from 0.9.5 to 0.9.6 and SQLAlchemy was changing, too. I wasn't sure I could finish it before the Apress book would be published. Many parts are also already in the http://wiki.pylonshq.com/display/pylonsdocs. But perhaps you folks believe that it would still give a nice newbie introductory article to follow. Then please give me a kick in the back and a bit of motivation and I'll try to finish the article. It's not yet complete but contains all kinds of the ideas and topics I intended to put into it. I'd also be glad to have other people contribute to it so we can share the workload. My current work is available here: Web: http://workaround.org/pylons/beginning-pylons.html Mercurial: http://workaround.org/cgi-bin/hg-beginning-pylons (No, I wouldn't want to write it online in the wiki. A traditional text editor and a good repository system is what I need to work. Confluence just got me mad.) Since I wanted to show something I extracted the technical bits off that document and at least published my Pylons cheatsheet for 0.9.6 that is available here: Web: http://workaround.org/pylons/pylons-cheatsheet.html Mercurial: http://workaround.org/cgi-bin/hg-pylons-cheatsheet The alternative paginator: ---------------------------- As some of you may know I have written an alternative to the pagination feature provided by the webhelpers module. It seems to be in use in some production sites already and be stable enough to be included in the webhelpers. Ben asked me to file a patch but I haven't yet done it. Mainly because I was too lazy to learn how he wanted the patch. :) Meanwhile James Gardner pimped my module a litte and uploaded it to PyPi as an alternative alternative paginator. Hmmm, things because confusing. James mailed me about that afterwards so I decided to adopt his ideas but clean up the whole module. For the last days I have worked on the new version which is now more powerful and more customizable. James didn't yet comment on it. But I'm using it in a beta site at work. I'd like other people to use it, too, and give a thumbs up/down. Mercurial: http://workaround.org/cgi-bin/hg-paginator Please see the docs/main.txt for a few notes on what has changed. I intend to put up an online demo of what you can do with it. Planet Pylons: ------------------ I hate blogs. People write so much boring crap. The worst thing is planet.debian.org where fellow Debian developers bore me to death and later claim that "the information has been published" by blogging it there hidden underneath a pile of soporific personal spam. Argh! But Pylons is moving. And people find out interesting things and develop nifty ideas every day. We discuss them on IRC but in this case I'd love to have a planet pylons. <thinking>The "planet" software would be a possible choice for an aggregator.</thinking> Cheers Christoph P.S.: Thanks again to YGingras - Mercurial is so great! :) --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "pylons-discuss" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/pylons-discuss?hl=en -~----------~----~----~----~------~----~------~--~---
