Opened 17 years ago
Closed 17 years ago
#4777 closed (worksforme)
Documentation detail pages should have a link back to the doc index
Reported by: | Owned by: | Jacob | |
---|---|---|---|
Component: | *.djangoproject.com | Version: | dev |
Severity: | Keywords: | ||
Cc: | Triage Stage: | Design decision needed | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
This document is very sketchy. In particular, it doesn't how to start django or where to go next. It mentions you can run django as a development HTTP server but it doesn't say how.
Change History (4)
comment:1 by , 17 years ago
Resolution: | → invalid |
---|---|
Status: | new → closed |
comment:2 by , 17 years ago
You're right, I was unclear. I was speaking of this document
http://www.djangoproject.com/documentation/install
Which gets you to install it but doesn't actually say how to get anything running nor what the next step is. The problem is that you need to see it from the parent document (http://www.djangoproject.com/documentation/) where it makes sense. As a stand alone document, it just sort of ends with crap on my filesystem and nothing running and no direction where to go next.
It's not a big deal. I think I was just frustrated at the time.
comment:3 by , 17 years ago
Component: | Documentation → Django Web site |
---|---|
Resolution: | invalid |
Status: | closed → reopened |
Summary: | Document is incomplete → Documentation detail pages should have a link back to the doc index |
Triage Stage: | Unreviewed → Design decision needed |
Thanks for the feedback, that's a lot more helpful.
You're right that it does make more sense when viewed from the parent document. The "installation" document handles just that.
I guess the "bug" here is that from a documentation page on the site, it isn't clear that you are actually just viewing one of a selection of available documentation pages.
comment:4 by , 17 years ago
Resolution: | → worksforme |
---|---|
Status: | reopened → closed |
The light green bar at the top of the page that says "Django documentation" links back to the docs.
I'm not sure which "document" you refer to. If you follow through the installation guide then the tutorial, you should be able to understand this.
Come back and post a ticket after that if you can offer a specific suggestion to improve the documentation.