Re: Upcoming sprint to update Django's tutorial

2012-08-04 Thread Jeremy Dunck
Hey all, just a quick reminder - we're running this docs sprint today, starting now. If you'd like to participant remotely, join #django-sprint. If you are a core contrib and might -1 our changes, I'd love to hear feedback. :) I'll put up a page with some useful links soon, and it will be linked

Re: Upcoming sprint to update Django's tutorial

2012-07-17 Thread Marijonas Petrauskas
+1! Few other thoughts - It would also be nice to have best practices regarding version control system file layout (eg. local settings pattern). Besides, I think that tutorial (and overall Django) recommendation to use absolute paths for project-relative locations (templates, static dirs) in setti

Re: Upcoming sprint to update Django's tutorial

2012-07-17 Thread Luke Granger-Brown
I think it would be good to make a new documentation page suggesting various best practices - speaking from my point of view, it was hard for me to figure out what I *should* be doing, because everyone was doing it differently and each method had their own pros and cons. I ended up using a mishmash

Re: Upcoming sprint to update Django's tutorial

2012-07-17 Thread Alex Ogier
On Tue, Jul 17, 2012 at 3:07 PM, Jeremy Dunck wrote: > I was wondering if people would be opposed to an opinionated tutorial? > For example: you should use virtualenv and pip, south, should handle > requirements this way, should prefer factories over fixtures, should > have this project director

Re: Upcoming sprint to update Django's tutorial

2012-07-17 Thread Jacob Kaplan-Moss
On Tue, Jul 17, 2012 at 12:07 PM, Jeremy Dunck wrote: > I was wondering if people would be opposed to an opinionated tutorial? > For example: you should use virtualenv and pip, south, should handle > requirements this way, should prefer factories over fixtures, should > have this project director

Re: Upcoming sprint to update Django's tutorial

2012-07-17 Thread Jeremy Dunck
Thanks for the pointers to existing tickets. I was wondering if people would be opposed to an opinionated tutorial? For example: you should use virtualenv and pip, south, should handle requirements this way, should prefer factories over fixtures, should have this project directory layout, etc. I

Re: Upcoming sprint to update Django's tutorial

2012-07-16 Thread Aymeric Augustin
2012/7/16 Jeremy Dunck : > On August 4, PyLadies SF will collaborate with Django sprinters in San > Francisco to improve the Django tutorial. Hi Jeremy, This is an excellent idea! Some people have worked on new tutorials but the patches weren't reviewed and committed. Groups of sprinters have a m

Upcoming sprint to update Django's tutorial

2012-07-16 Thread Jeremy Dunck
On August 4, PyLadies SF will collaborate with Django sprinters in San Francisco to improve the Django tutorial. I expect around 30 people will attend, including Alex Gaynor and Karen Rustad ( http://pyvideo.org/video/713/improving-documentation-with-beginners-mind-o ). We'll run a prep session