Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

This looks like it might eventually become a useful resource, as there is nothing else out there with its particular approach and combination of topics, and it seems fundamentally sound.

However, I wouldn't recommend trying to learn from it in its current form, unless you already know a lot.

Just skimming over it, I found that it was teeming with grammatical errors and typos, with entire sentences garbled to the point where I couldn't tell what the authors had intended to say. I saw syntax errors in the code samples, which means that they weren't all verified to run as printed. Again, not a real problem except for beginners, but beginners are the target audience.

Finally, there is some utility to the concept of prerequisite that the authors seem to avoid.

This book tries to teach the beginner everything that he might need to know, from what "ls" does in the shell to how to use git and set up virtual environments. Maybe it is practical to go from never having seen the command line to deploying working, secure Django projects just by using a (cleaned up version of) this book, but doesn't it make more sense to learn things in a more solid progression of stages? It's OK to expect the student to already know some basics, and build on those. You don't find a tutorial on arithmetic in a book about topology.



Yeah but I think more beginner material should spell out the proper way of doing things even if it is "unrelated". My pet peeve is beginner material that reads something like:

"to make this example simpler, I am going to do something incredibly insecure. In production you would never ever do this, but I'm still going to do it, so if you are unfamiliar with foo, make sure you know all about bar too."

As well, if I was teaching someone Django/Python development from scratch today, I would definitely include pip, virtualenv, and git/mercurial as part of the baseline. HTML is a hypertext medium so you could let people who know skip ahead.


"if I was teaching someone Django/Python development from scratch today, I would definitely include pip, virtualenv, and git/mercurial as part of the baseline."

They DO show you how to use pip, git, and virtualenv.

Check out the overview: http://www.tangowithdjango.com/book/chapters/overview.html#w...

One of the first things they explain is how to use pip: http://www.tangowithdjango.com/book/chapters/requirements.ht...

They also show how to get started with git: http://www.tangowithdjango.com/book/chapters/git.html#git-cr...

and virtualenv: http://www.tangowithdjango.com/book/chapters/requirements.ht...

edit: I actually think I might have misunderstood your comment. Sorry. Anyway, just leaving this comment here for posterity.


I'm a PHP developer, just used this guide to get Django up and running on my MacBook.. so far so good for me.


Thanks for the feedback and suggestions. It is work in progress, where we subscribe to the, Release Early and Release Often paradigm.

Thanks to many of the initial readers, we've been updating the book regularly and catching the typos and confusing parts of the book.

If you'd like to contribute then the source for the book is on github (written in Python Sphinx) see http://bit.ly/1bVKKJf


I definitely think you have a point about the target audience. This looks to be a great resource for someone wanting to get into django who has experience in other web frameworks.

I would recommend the site qualify what they mean with the term "beginner".


Thanks for all the comments and suggestions.

By "beginner" we mean, someone with knowledge of Python, and who has started to play around with Django (i.e. started to undertake the official django tutorials).

We started the book to help my 3rd year undergraduate computer science students, who learn python in 1st year.




Consider applying for YC's Summer 2026 batch! Applications are open till May 4

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: