Re: Docs docs docs!

2008-05-01 Thread Ben Bangert
On May 1, 2008, at 5:33 AM, Graham Higgins wrote: gettingstarted configuration controllers templates helpers models testing debugging deployment I've been playing with a candidate structure which attempt to integrate some of the pre-existing documentation. (Ben, it's not cl

Re: Docs docs docs!

2008-05-01 Thread Mike Orr
2008/5/1 Graham Higgins <[EMAIL PROTECTED]>: > (Ben, it's not clear whether you intend to "Re-do from start" or to > integrate the pre-existing pylonsdocs material in confluence where it > is relevant to the new structure, Probably. The docs were updated for 0.9.6, and Pylons hasn't changed t

Re: Docs docs docs!

2008-05-01 Thread Graham Higgins
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 30 Apr 2008, at 20:25, Ben Bangert wrote: > a single script that will create a virtualenv ... > > To run it, just use the following command: > curl http://pylonshq.com/download/0.9.7/go-pylons-dev.py | python - > --no-site-packages superdevenv

Re: Docs docs docs!

2008-04-30 Thread Ben Bangert
On Apr 30, 2008, at 12:25 PM, Ben Bangert wrote: To run the Sphinx build locally, first install Sphinx: ./superdevenv/ bin/easy_install -U Sphinx. Then go to superdevenv/pylons/pylons/ docs and type: make html The easy_install step shouldn't be required now, I've added Sphinx to the auto-in

Re: Docs docs docs!

2008-04-30 Thread Ben Bangert
I've gotten the basic Sphinx setup working now, and have gotten the Getting Started doc done. Here's what the Sphinx doc build looks like so far: http://docs.pylonshq.com/ I've got most of the module API docs laid out too. I should note that this doc effort covers a few related packages as

Re: Docs docs docs!

2008-04-30 Thread Ben Bangert
On Apr 21, 2008, at 3:04 AM, Graham Higgins wrote: Have you considered Creative Commons as an alternative? It might fit the bill. And, out of idle curiosity, what will be the legal entity that owns t'other half of the rights under a repoze-style licence I'm not entirely sure. After reading ov

Re: Docs docs docs!

2008-04-21 Thread Mike Orr
On Mon, Apr 21, 2008 at 3:04 AM, Graham Higgins <[EMAIL PROTECTED]> wrote: > It seems a bit US-centric tho' (c.f. the crypto > clauses and mention of "the government') All your documentation are belong to us. The crypto clause is a bit over the top considering that standard web encryption is no

Re: Docs docs docs!

2008-04-21 Thread Graham Higgins
On Apr 20, 1:27 am, Ben Bangert <[EMAIL PROTECTED]> wrote: > Repoze has a rather nice form put together > here:http://repoze.org/contributing.html > > I'll modify as needed for those wishing to contribute to the Pylons > core docs. That work for everyone? I'm relaxed about it. It seems a bit US

Re: Docs docs docs!

2008-04-19 Thread Ben Bangert
On Apr 9, 2008, at 6:08 AM, Graham Higgins wrote: I'd like to be involved Great to see you getting back into the docs! I'm assembling the first revision of the Pylons docs that will use Sphinx and be in the Pylons repo so that anyone installing Pylons will have a copy of the docs with th

Re: Docs docs docs!

2008-04-09 Thread Graham Higgins
Ben Bangert wrote: > I'd like to assemble a group of other people who are interested in > working on the docs for Pylons. > If you'd like to help work on the docs in any of these ways: > Please let me know. I'd like to be involved. --~--~-~--~~~---~--~~ You receive

Re: Docs docs docs!

2008-04-07 Thread Ches Martin
Ben, I'm a little late to the party and a bit out of touch with Pylons for the past couple of months, but I've been all for some form of doc sprint for awhile. If there's still a concerted effort forthcoming or ongoing with this, I'm glad to help where I can. Sphinx is looking good. It'd probabl

Re: Docs docs docs!

2008-03-24 Thread zir . echo
Hi, I'm new to pylons, I'm interested in Testing, WebOb and caching. I'm not native English speaker too. But maybe I can help the i18n part. Let me know if anything I can help. Kind regards, z. On Mon, Mar 24, 2008 at 2:51 PM, Ben Bangert <[EMAIL PROTECTED]> wrote: > I've been reading carefully

Re: Docs docs docs!

2008-03-24 Thread wongobongo
I can help out writing docs. I'll read up on this Sphinx thing today. K On Mar 23, 11:51 pm, Ben Bangert <[EMAIL PROTECTED]> wrote: > > If you'd like to help work on the docs in any of these ways: > - Write docs > - Grammar / spelling checking > - Copy editing (consistent usage of terms, tone of

Re: Docs docs docs!

2008-03-24 Thread Max Ischenko
On 3/24/08, Ben Bangert <[EMAIL PROTECTED]> wrote: > > I've been reading carefully through the docs for Sphinx ( > http://sphinx.pocoo.org/ > ) the past few days, and am quite sold on it at this point. As such, > I'd like to assemble a group of other people who are interested in > working on the do