Opened 9 years ago

Closed 9 years ago

#4777 closed (worksforme)

Documentation detail pages should have a link back to the doc index

Reported by: fishbolt@… Owned by: Jacob
Component: * Version: master
Severity: Keywords:
Cc: Triage Stage: Design decision needed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:


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 Changed 9 years ago by Chris Beaven

Needs documentation: unset
Needs tests: unset
Patch needs improvement: unset
Resolution: invalid
Status: newclosed

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.

comment:2 Changed 9 years ago by Charlie Reiman

You're right, I was unclear. I was speaking of this document

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 ( 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 Changed 9 years ago by Chris Beaven

Component: DocumentationDjango Web site
Resolution: invalid
Status: closedreopened
Summary: Document is incompleteDocumentation detail pages should have a link back to the doc index
Triage Stage: UnreviewedDesign 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 Changed 9 years ago by Adrian Holovaty

Resolution: worksforme
Status: reopenedclosed

The light green bar at the top of the page that says "Django documentation" links back to the docs.

Note: See TracTickets for help on using tickets.
Back to Top