#25713: Create a new tutorial
-------------------------------+--------------------
Reporter: EvilDMP | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------
Our tutorial is excellent, but I think we need to be able to address a
wider audience with it.
Our tutorial works much better for people who have some programming
experience than for those who are coming from a web design background.
I want it to be an entry point for someone who knows HTML and CSS (but not
Python, or even programming in general), and wants to move on from static
sites or using other people's applications to building their own
applications.
Part of PHP's success has been the ease with which it allows HTML/CSS
developers to enter into programming by starting with the things that they
are already familiar and comfortable with. We'll never be able to match
that with Python, but I think we can get much closer to it.
At the same time I want to make the effort/result cycle in the tutorial
much tighter than it is now, particularly from the point of view of the
very novice or non-programmer.
== Proposed approach ==
'''I don't propose to replace the existing tutorial''', but will add to it
- in fact, creating an ''alternative'' entry-point that takes a different
approach, and converges on the same outcome, rejoining the flow of the
existing tutorial at a later point.
The tutorial will diverge from the existing tutorial after
https://docs.djangoproject.com/en/dev/intro/tutorial01/#creating-the-
polls-app, and rejoin it at
https://docs.djangoproject.com/en/dev/intro/tutorial05/ (with some minor
reshuffling to make it all work together properly).
I'll do the work in two tranches
* some changes to the application that the existing tutorial creates, to
make it more suited to the new tutorial
* the addition of the new material
For the future I envisage the possibility of adding further entry-points
or paths through the tutorial (for example, a path aimed at PHP
programmers, or one for JavaScript developers who want learn how they
might add Django backend applications to their JS projects), so part of
the work will be to open up the tutorial to this sort of extension.
--
Ticket URL: <https://code.djangoproject.com/ticket/25713>
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 unsubscribe from this group and stop receiving emails from it, send an email
to django-updates+unsubscr...@googlegroups.com.
To post to this group, send email to django-updates@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/050.efc389551449c929cb60e0ebf74526cc%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
