Opened 12 years ago
Closed 12 years ago
#19857 closed Cleanup/optimization (fixed)
Update documentation to include ALLOWED_HOSTS section.
Reported by: | anonymous | Owned by: | nobody |
---|---|---|---|
Component: | *.djangoproject.com | Version: | 1.4 |
Severity: | Normal | Keywords: | ALLOWED_HOSTS, documentation, settings file |
Cc: | Triage Stage: | Accepted | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
Comment in default settings file has invalid url https://docs.djangoproject.com/en//ref/settings/#allowed-hosts
Searched docs for ALLOWED_HOSTS but found nothing other than Django 1.4.4 release notes.
Change History (8)
comment:1 by , 12 years ago
comment:2 by , 12 years ago
Resolution: | → fixed |
---|---|
Status: | new → closed |
comment:5 by , 12 years ago
Crap. I missed that the {{ docs_version }}
project-template substitution was new in trunk, so the link in the project-template settings.py to the documentation for ALLOWED_HOSTS
will be broken in all new projects under 1.3.6, 1.4.4, and 1.5c2.
This alone is probably not worth a re-release. Is it possible to add a redirect at dp.com so that https://docs.djangoproject.com/en//ref/settings/#allowed-hosts redirects to https://docs.djangoproject.com/en/1.4/ref/settings/#allowed-hosts ? That'll send 1.3 users to the 1.4 docs, but it's better than a broken link; the ALLOWED_HOSTS
documentation is the same for 1.3 and 1.4. (We shouldn't send them to any more recent docs, as those will show an empty list instead of wildcard default value; if we send them to 1.4 then 1.5c2 users will see the wrong default, but better to do that to RC users than production release users, since this'll be fixed correctly for 1.5 final).
comment:6 by , 12 years ago
Resolution: | fixed |
---|---|
Status: | closed → new |
Reopening, since I don't think this is adequately fixed until we do something to help people who will continue to hit this with 1.3.6 and 1.4.4.
comment:7 by , 12 years ago
Component: | Documentation → *.djangoproject.com |
---|---|
Easy pickings: | unset |
Triage Stage: | Unreviewed → Accepted |
I've set up a redirect from /en//ref/settings/
to /en/stable/ref/settings/#allowed-hosts
, but for a reason I can't explain, it doesn't work. The same redirect works just fine in dev :(
comment:8 by , 12 years ago
Resolution: | → fixed |
---|---|
Status: | new → closed |
Closing this; I suspect the problem with the redirect might be that the front-end webserver in production replaces the double slash with a single one, but I don't think it's worth messing with redirects, since we'll have new 1.3 and 1.4 releases today anyway, and a new 1.5 in a week.
Thanks for the report. The URL it should be linking you to is https://docs.djangoproject.com/en/1.4/ref/settings/#allowed-hosts - the setting is documented in the 1.4 docs, but apparently the search indexing hasn't caught up yet.
The broken link in the new-project template settings is a bug.