#16671: 5th tutorial on turning Polls into a reusable app
-------------------------------+------------------------------------
Reporter: stumbles | Owner: ben@…
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+------------------------------------
Comment (by tswicegood):
Just read through the tutorial. It looks good, but I don't know if it's
the right thing to be teaching to someone at this point in their Django
career. Reusable apps are something I would consider an advanced topic to
be included as the final tutorial entry, if the topic belongs there at
all. If you look at who the tutorial is geared at (someone definitely new
to Django, but probably also new to Python), this tutorial is going to
leave them scratching their head. What does in to the `setup.py`? (Can I
include my own URL, or does it have to be example.com? Does every
reusable app for Django have to have `django-` in front of the directory
name?) What does the `MANIFEST.in` file do and why is it there? (Do
`.in` files have some special meaning in Python in general? Can they do
other things?)
In it's current state, I'm -1. I think this is a good foundation, but it
needs to be fleshed out quiet a bit before it should be merged. I'm also
-0 on whether reusable apps should be part 5 of the tutorial. I think
tutorial 4's current list of next topics provides a really good starting
point for further tutorials and that this is best left to a final spot or
possibly even as part of the main documentation rather than the tutorial.
--
Ticket URL: <https://code.djangoproject.com/ticket/16671#comment:17>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to django-updates@googlegroups.com.
To unsubscribe from this group, send email to
django-updates+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
