| published by | Software Crafts |
|---|---|
| in blog | Software Crafts |
| original entry | A Django roadmap for newcomers |
There is a variety of questions that is asked often enough by newcomers to Django which is along the lines that they have completed the tutorial, then they feel a bit lost at what to do next. This also often crops up within with in the specific realm of create web APIs as well.
The answer often given is to crack on with project and then ask specific questions/problems as they come up. I find this answer truthful but lacking as it assumes the question asker is familiar with how "the web" (HTTP, client/server model, data modelling, Content types and whole lot of other theory) works and that they haven't learned some falsehoods or bad practices along the way.
Essentially what they are lacking is a direction or roadmap after the tutorial. The documentation is dense, post the tutorial, it suggests reusable apps as the next thing that looks like a tutorial, or it's a page which details how to read the docs, but gives no hint on what topics would be appropriate to read next. Just today a newcomer mentioned the docs being too dense and honestly I wouldn't want to change that, the depth and density is a reassurance to myself knowing that there is more to learn a decade in.
What I am suggesting is that we create a direction of travel for newcomers. The website roadmap.sh would be an excellent tool to create this roadmap or at least create a draft to then be formatted into a new documentation page. Perhaps doing a more Django specific version of this one?
Off the top of my head we probably need to be pointing newcomers to the auth docs, the admin docs, ORM pages and also sites like ccbv and djangopackages and other recommended third party packages.
Do you agree? Should this be a new docs page?