Opened 7 years ago

Closed 7 years ago

#8944 closed (invalid)

Documentation should go further than just your first application

Reported by: simon Owned by: nobody
Component: Documentation Version: 1.0
Severity: Keywords: djangocon
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

Adrian and Jacob on stage at DjangoCon.

Adrian: "maybe we should link to a video of James' DjangoCon talk at the end of the tutorial"

Change History (4)

comment:1 Changed 7 years ago by kratorius

  • Component changed from Uncategorized to Documentation
  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset

comment:2 Changed 7 years ago by akaihola

I was helping someone on the #django IRC channel today, and he/she hadn't yet understood how functionality can be divided into separate apps.

I took a look at the contents of the Django documentation and the 1st edition of the Django Book, but couldn't find anything appropriate there to suggest for reading. I also found it non-trivial to explain app layout quickly.

The specific problem of the person in IRC had to do with multiple sites using common functionality. I pointed them to the sites framework, but in addition to that they need a basic understanding of the app system.

mattmcc pointed out the blog post at http://www.b-list.org/weblog/2006/sep/10/django-tips-laying-out-application/

I suggest that app layout be explained in the documentation with examples.

comment:3 Changed 7 years ago by jacob

It's not clear what to do with this other than continue to write more and better docs.

comment:4 Changed 7 years ago by jacob

  • Resolution set to invalid
  • Status changed from new to closed
Note: See TracTickets for help on using tickets.
Back to Top