Code

Opened 6 years ago

Closed 5 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"

Attachments (0)

Change History (4)

comment:1 Changed 6 years ago by kratorius

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

comment:2 Changed 5 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 5 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 5 years ago by jacob

  • Resolution set to invalid
  • Status changed from new to closed

Add Comment

Modify Ticket

Change Properties
<Author field>
Action
as closed
as The resolution will be set. Next status will be 'closed'
The resolution will be deleted. Next status will be 'new'
Author


E-mail address and user name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.