Opened 11 years ago
Closed 11 years ago
#19452 closed Uncategorized (duplicate)
your documentation is a poor introduction to a seemingly brilliant idea
| Reported by: | anonymous | Owned by: | nobody |
|---|---|---|---|
| Component: | Documentation | Version: | 1.4 |
| Severity: | Normal | Keywords: | |
| Cc: | Triage Stage: | Unreviewed | |
| Has patch: | no | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | no | UI/UX: | no |
Description
i'm working on windows vista.
i've installed activestate python 2.7, eclipse and pydev.
i installed django with AS python package manager PYPM.
your documentation is very easy to read - i really like the style of writing - but your 'hello world' project is awful!
you tell people to put a command in the python shell that has about a 50/50 chance of working - if the number of people inquiring on sites like stackoverflow about how to get django-admin.py working is anything to go by - and if it doesn't work, you suggest altering the os registry or 'symlinking'!?? It is the FIRST THING PEOPLE DO!!!
why not just give us a command that we can use? I've altered my registry with RegEdit, adding a key to the command or module in question and it still doesn't work. Why not just explain a temporary workround? I want to get a database/website cranked up and i'm wading through information about windows misinterpreting hashbang headers!
The problem described here is essentially the same as #19344.
We've tried various permutations of this in the past and none works for everyone :(
To be fair, this is more a problem with the state of Python (and Python packaging) on Windows than with Django itself.