Re: Django documentation for newer users

2010-03-05 Thread Emre Yılmaz
although it is not the best, django is well documented imo. (my favorite after php manual) browsing the source is not bad at all when the documentation is not enough for the developer. you become more familiar to the django if you dive in to the source. it is very handy when you need some

Re: Django documentation for newer users

2010-03-05 Thread stherrien
Your right the docs are there and they are very useful I think. I missed a few things when opening this ticket let me be more precise I would like to see the module index at the top of the actually module doc page. The module index's are offered as separate link on the docs page which lists the

Re: Django documentation for newer users

2010-03-05 Thread Waylan Limberg
On Fri, Mar 5, 2010 at 11:35 AM, stherrien wrote: > What I'm suggesting is that we setup something to allow everyone to > improve the docs with help from the core django group. I think this > would be very helpful to everyone. if one of the core group would like > to help

Re: Django documentation for newer users

2010-03-05 Thread Peter Herndon
On Mar 5, 2010, at 11:35 AM, stherrien wrote: > What I'm suggesting is that we setup something to allow everyone to > improve the docs with help from the core django group. I think this > would be very helpful to everyone. if one of the core group would like > to help us get setup to do this it

Re: Django documentation for newer users

2010-03-05 Thread Karen Tracey
On Fri, Mar 5, 2010 at 11:40 AM, Karen Tracey wrote: > ... open a ticket and attach the patch. > > And, as for all other tickets, it'll help if you search the tracker first and make sure that whatever ticket you're planning on opening isn't already open. Karen -- You

Re: Django documentation for newer users

2010-03-05 Thread Alex Gaynor
Uhh... the documentation is part of djangos repository, along with all of the code. It has long been django's policy to treat docs contributios the same as code contributios. Alex On Mar 5, 2010 11:35 AM, "stherrien" wrote: What I'm suggesting is that we setup

Re: Django documentation for newer users

2010-03-05 Thread Sean O'Connor
The Django documentation is already included in code base with Django and anybody is welcome to submit patches for them. If you do a checkout of Django, there will be a "docs" directory there. Inside there is the full documentation source in reStructuredText. If you'd like a local HTML or PDF

Re: Django documentation for newer users

2010-03-05 Thread Gary Reynolds
That's interesting, I'm of the other belief... I find the Django documentation to be thorough and organised very well. One of the main reasons I (and I am sure countless others) even started using Django was because of it's excellent documentation. As the project has matured from version 0.96

Re: Django documentation for newer users

2010-03-05 Thread Karen Tracey
On Fri, Mar 5, 2010 at 11:35 AM, stherrien wrote: > What I'm suggesting is that we setup something to allow everyone to > improve the docs with help from the core django group. I think this > would be very helpful to everyone. if one of the core group would like > to

Re: Django documentation for newer users

2010-03-05 Thread stherrien
What I'm suggesting is that we setup something to allow everyone to improve the docs with help from the core django group. I think this would be very helpful to everyone. if one of the core group would like to help us get setup to do this it would be great. maybe if they setup a repository with

Re: Django documentation for newer users

2010-03-05 Thread stherrien
Exactly my point docs need to be more organization to be constructive for django users. On Mar 5, 11:05 am, Jared Forsyth wrote: > To be honest I am quicker to just go to django's source code rather than the > docs, as often I can find what I need there, and the docs

Re: Django documentation for newer users

2010-03-05 Thread Jared Forsyth
To be honest I am quicker to just go to django's source code rather than the docs, as often I can find what I need there, and the docs aren't (imo) organized enough to provide much of an advantage. On Fri, Mar 5, 2010 at 8:46 AM, stherrien wrote: > Hi all, > > > I have

Django documentation for newer users

2010-03-05 Thread stherrien
Hi all, I have a request that django documentation show the import locations for classes like in other well formed docs found on the web showing the users where the classes can be found for import. I think this would be handy for newer users and experienced users finding something new.