#16779: Add a tutorial for first time Django contributors
-------------------------------+------------------------------------
Reporter: taavi223 | Owner: taavi223
Type: New feature | Status: assigned
Component: Documentation | Version:
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 lrekucki):
Here's my 2 cents:
* Things like `./runtests.py` won't work on Windows unless someone has the
[http://blog.python.org/2011/07/python-launcher-for-windows_11.html
Windows Launcher]. `python runtests.py` works fine.
* There is a lot of talk about `PYTHONPATH`, but no real mention of how to
check or alter it. If we assume, the person reading knows how `PYTHONPATH`
works, then this whole paragraph could be a lot shorter. If not, then it
should show how to set it up properly.
* Sadly, we have a few testcases which depends on PIL. And on Windows,
installing PIL into a virtualenv in next to impossible (at least in my
expirience), so I actually never use `--no-site-packages` there.
* Speaking of which, there is no mentioned of what the test suite output
really means. Most people will get a lot of skipped tests unless they
install extra libraries. It would be good to mentioned that, as they might
as well be skipping tests related to what he they're changing.
* I know we don't want to teach people Git in that tutorial, but it would
be better to ask people to commit their changes and then generate a patch
using `git show` or even better `git format-patch`. `git diff` invoked
like this will omit any files a person may have added. Or maybe we can
leave this for a "advanced" part.
* The result of `git diff` needs updating ;)
--
Ticket URL: <https://code.djangoproject.com/ticket/16779#comment:16>
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.
