#16779: Add a tutorial for first time Django contributors
---------------------------------------+-------------------------------
Reporter: taavi223 | Owner: taavi223
Type: New feature | Status: assigned
Milestone: | Component: Documentation
Version: | Severity: Normal
Resolution: | Keywords:
Triage Stage: Accepted | Has patch: 1
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 1 | Easy pickings: 0
UI/UX: 0 |
---------------------------------------+-------------------------------
Changes (by gabrielhurley):
* needs_better_patch: 0 => 1
Comment:
This is looking really good. Tremendous effort.
My big comment is that I think the transition from generic initial setup
material blurs into the tutorial portion in a way that may confuse people
during the "Getting a copy of Django’s development version" section. As it
stands currently it's easy to think (from the eye jumping from the title
to the code snippet) that you check out Django's development version by
fetching revision 16558. I would move the steps for checking out a
specific revision of Django out of there and into a separate section
afterward which decisively kicks off the "tutorial" portion.
One small typo on line 70: "The first step to contributing to Django is to
check out ~~the~~ Django’s current development"
Same on line 185: "Navigate to ~~the~~ Django's
``tests/regressiontests/model_forms_regress/`` folder and open the
``tests.py`` file."
Lastly, this obviously all needs to be wrapped to an 80-character margin
once the text is final.
Thanks so much for taking this on. Great work!
--
Ticket URL: <https://code.djangoproject.com/ticket/16779#comment:6>
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 this group at
http://groups.google.com/group/django-updates?hl=en.
