Adding context to docs
I've been struggling to add forms to an app I am building, because the context of where to put form classes is missing in the docs. I don't want to take a guess, even if it's right, when I could be following best practice. In the 1.7 tutorial, the namespacing and file naming is laid out pretty simply, but in the Working with Forms page, https://docs.djangoproject.com/en/1.7/topics/forms/ which is the start of the overview, there is nothing setting out that I should, say, be using /myapp/forms.py . I think that would be a valuable thing to add to the docs. I've searched for where else it might be, and I can't find it, so even if it does exist elsewhere, the difficulty of finding this information is high. The tutorials have the name of file at the top of each example, which is my favourite solution, but even a briefing at the top of the forms overview would be an improvement on what is currently a low information zone. Currently, I don't have access to info on how to namespace my forms, and where to create what I'm creating. It's a small change that would make the docs clearer and easier to use. DP -- You received this message because you are subscribed to the Google Groups "Django developers (Contributions to Django itself)" group. To unsubscribe from this group and stop receiving emails from it, send an email to django-developers+unsubscr...@googlegroups.com. To post to this group, send email to django-developers@googlegroups.com. Visit this group at http://groups.google.com/group/django-developers. To view this discussion on the web visit https://groups.google.com/d/msgid/django-developers/f5a8e89f-d9d8-46a3-95b7-0b075c15fec4%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Re: Adding context to docs
Never done either of those things, and I'm completely not set up to do them. I will if creating this subject has made me the owner of it, but it's a lot more work for me than it would be for someone else. I'd start with the Writing your First Django Patch part of the tutorial, yes? Thanks for the explanation. I had a form in what I was pretty sure was the wrong place, and it was working, but it rankled so hard I had to look for why. -- You received this message because you are subscribed to the Google Groups "Django developers (Contributions to Django itself)" group. To unsubscribe from this group and stop receiving emails from it, send an email to django-developers+unsubscr...@googlegroups.com. To post to this group, send email to django-developers@googlegroups.com. Visit this group at http://groups.google.com/group/django-developers. To view this discussion on the web visit https://groups.google.com/d/msgid/django-developers/104d4863-aaac-44cc-a999-785fb242d266%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Re: Adding context to docs
The last time I logged into GitHub was at least one computer ago. And that computer blew up a bit. I'll try to get on, but this is contingent on many factors, and I don't have control over them all. What I will do is read the docs on contributing. Thanks for the time, both/all of you. Django is damned cool, and it's great to peek behind the curtain. -- You received this message because you are subscribed to the Google Groups "Django developers (Contributions to Django itself)" group. To unsubscribe from this group and stop receiving emails from it, send an email to django-developers+unsubscr...@googlegroups.com. To post to this group, send email to django-developers@googlegroups.com. Visit this group at http://groups.google.com/group/django-developers. To view this discussion on the web visit https://groups.google.com/d/msgid/django-developers/5b7c0974-0fc2-4654-8b8e-8c83808024d4%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
