Documentation should go further than just your first application

[simon]

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"

[Antti Kaihola]

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.

[Jacob]

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