News for hackers. Stuff that matters.
Re:Two Scoops of Django final edition released by clicks on Friday April 12, 2013 @05:07AM (#5537349)
Not to be so unreasonably negative here, but I've been pretty suspicious of the peculiar amount of attention this book has gotten.

I wish more effort was put into updating the /free/ Django book (created by Jacob Kaplan-Moss and Adrian Holovaty, the creators of Django): http://www.djangobook.com/en/2.0/index.html -- what's fantastic about the Django book is it could be read by a complete novice with no prior experience of webapp development, indeed it introduces the patterns to a MVC framework in a great way with wonderful analogies. Novices are not going to have a fun time with TSoD.

edit: As stevejalim has pointed out, jacobian is taking pull requests to update the book for Django 1.5: https://github.com/jacobian/djangobook.com/blob/master/READM... -- have a go!

Re:Two Scoops of Django final edition released by jacobian on Friday April 12, 2013 @09:47AM (#5538415)
I've got to say, this comment makes me rather sad and angry.

Sad, because Two Scoops is a wonderful book. Danny and Audrey spent a ton of time soliciting feedback from a veritable Who's Who of the Django community, and they took that feedback incredibly seriously. The result is a book that does a better job encapsulating how to write successful Django code than anything anyone else has written.

Angry, because of the implied slight against Audrey and Danny. It's sucks that you're too "suspicious" to consider that it might be getting so much attention because it's damned good. When you say that the book is getting "a peculiar amount of attention", it really sounds like you're suggesting some sort of scam. That assumption of bad faith is really offensive -- and completely incorrect. The book's getting attention because it's awesome.

Also angry because of of the implicit demands on my free time that you're making. Writing a book is fucking hard, and I haven't had the time to keep it updated. You're not entitled to my free time.

To end on a positive note, though: the book is getting updated. There's a new author working on a 3rd edition, to be released later this year. I'm not sure if the author wants to be named publicly, but it's someone I know and trust to do an great job.

Re:Two Scoops of Django final edition released by clicks on Friday April 12, 2013 @09:54AM (#5538456)
It appears my observations were off. Consider my earlier comment recanted (it seems I can't modify/delete it now).
Re:Two Scoops of Django final edition released by benjamincburns on Friday April 12, 2013 @11:14AM (#5538923)
As a casual observer, a second Thanks. It's really really nice to see someone on the internet say the equivalent of "sorry, I was wrong."
Re:Two Scoops of Django final edition released by jacobian on Friday April 12, 2013 @09:55AM (#5538465)
Thanks.
Re:Two Scoops of Django final edition released by rbanffy on Friday April 12, 2013 @01:35PM (#5539913)
> You're not entitled to my free time.

I would like to volunteer some of my own free time to help. What would be the best way to contact you?

Re:Two Scoops of Django final edition released by elithrar on Friday April 12, 2013 @05:14AM (#5537382)
> Not to be so unreasonably negative here, but I've been pretty suspicious of the peculiar amount of attention this book has gotten.

What makes you suspicious? I like TSoD because it fills that gap between the official docs and SO/mailing lists: it's a collection of "best practice" advice for those who have already had exposure to Django.

It's a completely different approach from the Django Book, and I don't think this is a problem. They are targeting different demographics.

Re:Two Scoops of Django final edition released by aravenel on Friday April 12, 2013 @10:22AM (#5538610)
Absolutely. They are very different. The Django Book is a tutorial--very useful, and I do wish that it got more support. I will have to see what I can do with helping to update it for Django 1.5.

But TSoD is a different animal--it's not a "How to learn Django" guide, it's a "How to use Django in the real world" guide. It's not teaching you how to setup models and forms, it's the step beyond that--once you know how to use it, how do you use it well, in production environments? Things that most decent Django programmers know, but that are very hard for those just getting started to figure out except through trial, error, and hours of Googling. There's a big gap in literature here, and not just for Django. I'm happy to see someone addressing it.

Re:Two Scoops of Django final edition released by ericd on Friday April 12, 2013 @06:59AM (#5537750)
Thanks for mentioning that! I'm just getting into Django, and a friend recommended getting TSoD, and it's been pretty spectacularly unhelpful for actually learning how to do the basics like deployment (though I could see how it would be useful for clearing up bad habits). The Django book looks absolutely fantastic for learning the basics, better than most commercial software books I've read in the past. Wonder why they don't point to it explicitly in the Django docs tutorial.

Edit: Never mind - while it's good, I've already run into a couple areas where it seems to be severely outdated, so I could see why it wouldn't be advertised too heavily.

Re:Two Scoops of Django final edition released by pydanny on Friday April 12, 2013 @10:05AM (#5538516)
We've gone back and forth on how much to put in the deployment chapter. Our concern is that deployment is one of those areas that has very good documentation, is discussed frequently at meetup groups, and best practices actually change more frequently than people realize. For example, many people got on our case about not including uWSGI or even bothering to include Apache!

In any case, I would love to hear your feedback on other areas.

Re:Two Scoops of Django final edition released by ericd on Saturday April 13, 2013 @05:50AM (#5543014)
Hey, thanks for responding. Sorry if the tone came across as harsh at all, it's quite good, it's just not the sort of book I was expecting. I was hoping it was a more comprehensive A-Z sort of book to learn the surface of everything it takes to get started, like "Agile Web Development with Rails" by Dave Thomas and DHH was for Rails, or the Django Book seems to be for early versions of Django.
Re:Two Scoops of Django final edition released by stevejalim on Friday April 12, 2013 @05:45AM (#5537474)
Related to the Django Book, this is a quick PSA that the source for it is now on Github and that jacobian is welcoming pull requests to help update it[1]: https://github.com/jacobian/djangobook.com/blob/master/READM...

[1] https://github.com/jacobian/djangobook.com/pulls

Re:Two Scoops of Django final edition released by PuercoPop on Friday April 12, 2013 @03:24PM (#5540509)
The books are not trying to fill the same role. They are not in opposition but complement each other. 2 Scoops of Django is a book about patterns common to Django, from how to manage settings for multiply environments, to how to use CBV effectively. The book showed me that the idea of CBV is to compose orthogonal functionality rather than a crutch because Django's url dispatcher doesn't have method introspection.

p.d. I dislike the initial sentence of your comment as it implies certain greed from the authors. They are committed to the idea that money shouldn't be a barrier for knowledge and they will mail you a copy of the book if you ask for it, no strings attach. They sent one to me. My email didn't try to justify or imply I couldn't afford it, I just wanted to check if they would follow up in they claim. They sent my a copy right away and asked me why I was asking for one (are you a student, etc?). As he had already sent me a copy his question was of genuine interest imho. And to me the fact that he would sent the book to anyone who ask speaks volumes of his commitment to the idea that knowledge should be free.

My 2c.

Re:Two Scoops of Django final edition released by Einherji on Friday April 12, 2013 @05:18AM (#5537398)
I bought the "beta" edition of the book and really enjoyed it so far. I think it covers different topics than the free django book and I absolutely think they are both valuable resources. On a related note, I always seem to get more out of books that I payed for, similar to how expensive wine always tastes better. Anyone else experience this?
Re:Two Scoops of Django final edition released by pekk on Friday April 12, 2013 @03:20PM (#5540494)
You may get more out of things you paid for because you do not want that money to have been wasted, similar to how the same wine is rated better if it is more expensive (in blind tests).
Re:Two Scoops of Django final edition released by lgp171188 on Friday April 12, 2013 @09:32AM (#5538324)
Sorry for being a jerk, but did you pay for Django?
Re:Two Scoops of Django final edition released by e12e on Friday April 12, 2013 @10:10AM (#5538543)
No, but a lot of companies did by paying people to work on Django projects, and allowing contributions back into the Free project?

I've not heard of any companies (except some colleges) funding actual books in a similar way -- probably because if you pay someone to improve Django, your product (based on Django) improves, and you presumably make money from your product.

Paying someone to write general documentation helps train both your and other's developers -- but the link to profit is more indirect -- writing proper text books is not something that makes sense to in-source for most institutions (shorter tutorials, technical documentation etc, being something different).

Re:Two Scoops of Django final edition released by pydanny on Friday April 12, 2013 @10:09AM (#5538541)
Like many people, I 'paid' for Django via contributions of my time.
Re:Two Scoops of Django final edition released by Einherji on Friday April 12, 2013 @06:28PM (#5541473)
I agree 100%. Django may be free to use but lots of people contribute their time to to project. When I have enough experience working with it I plan to give back to the community as much as I can, that is how I will pay for django.
Re:Two Scoops of Django final edition released by vickytnz on Friday April 12, 2013 @09:38AM (#5538361)
The whole open source eco-system has similar things e.g. Drupal books and so-so online documentation (I can attest to this one), Joomla, WP …. Books are much like doing workshops, they're a shortcut for those who are prepared to pay rather than have to do a lot of online searching.
Re:Two Scoops of Django final edition released by raverbashing on Friday April 12, 2013 @10:36AM (#5538697)
These are two different books

One is for beginners, another is for advanced users (2SoD)

Re:Two Scoops of Django final edition released by pistoriusp on Friday April 12, 2013 @05:13AM (#5537376)
Not really sure why you think they both can't coexist, and why you placed so much emphasis on free?
Re:Two Scoops of Django final edition released by clicks on Friday April 12, 2013 @05:20AM (#5537403)
> Not really sure why you think they both can't coexist

Sure, they could and they should, however I think TSoD might have dampened the community's efforts of improving and updating the free and more official 'Django Book' when it really needed the work.

Re:Two Scoops of Django final edition released by elithrar on Friday April 12, 2013 @06:40AM (#5537686)
> Sure, they could and they should, however I think TSoD might have dampened the community's efforts of improving and updating the free and more official 'Django Book' when it really needed the work.

TSoD was the effort of two individuals: they can spend their time how they like. I also can't blame them for wanting to make some money back on their time, given that writing a technical book is a non-trivial exercise.

It also takes a completely different set of skills to write a "beginner's book", which is really what the Django Book is.

Re:Two Scoops of Django final edition released by pydanny on Friday April 12, 2013 @10:08AM (#5538537)
Just so you know, we offer the book for free to developers in need. Please go to http://django.2scoops.org/ and scroll to the bottom.

Also, in my own case, just because I co-wrote TSoD doesn't mean I'm going to stop contributing to Django or it's documentation. In fact, writing it helped illuminate areas in the Django documentation that I believe I can improve. I hope readers of the book take the same approach. We all benefit from creating new and improved resources.

Re:Two Scoops of Django final edition released by vfulco on Friday April 12, 2013 @10:31AM (#5538668)
This is just a phenomenal book. After reading the Django docs a few times, I dove into TSoD and realized it was way over my head but the content was excellent from a pragmatic, "get things done", "I was wondering about that" point of view. After going back to Django docs and starting Kenneth Love's Get Started with Django Series then returning back to TSoD, I am even more impressed with the insights and breath of the book. Even as a noob, I consider it a must have reference. Do you really want to go thru all the mistakes, errors and pitfalls that the authors are warning you away from? Some things in life are just genuinely good and of the highest quality PERIOD. Stop being so jaded gang.
Re:Two Scoops of Django final edition released by fijter on Friday April 12, 2013 @05:05AM (#5537342)
Bought the PDF beta once it was posted here on HN with the hope you guys would be nice and provide an EPUB version later on. Just want to say thank you for listening and doing so! If you haven't bought this book and are in some way (beginner or veteran) a Django developer go and buy it, there is always something new to learn even for the most experienced.
Re:Two Scoops of Django final edition released by khalstvedt on Friday April 12, 2013 @11:46AM (#5539137)
I'm glad this has gotten the attention it deserves; I purchased the beta when embarking on my first Django project, and it was a bit over my head at the time. Now, however, 2SoD fills the important role of an up-to-date best practices guide, which I find is often hard to compile in largish community projects with fragmented documentation.

Not that the official docs aren't good, because they are; the 2SoD authors just get to be a little more narrow and opinionated.

Re:Two Scoops of Django final edition released by kstrauser on Friday April 12, 2013 @03:06PM (#5540424)
I love - absolutely just adore - that the DRM on the PDF copy I bought is having my name embedded in the cover. I can view it on my work desktop, my home laptop, my iPad, or my Nook without jumping through any hoops at all.
Re:Two Scoops of Django final edition released by pydanny on Friday April 12, 2013 @03:15PM (#5540467)
DRM free is the only way to go. :-)
Re:Two Scoops of Django final edition released by kstrauser on Friday April 12, 2013 @03:22PM (#5540501)
Well, it's appreciated. Thanks for trusting and respecting your buyers!
Re:Two Scoops of Django final edition released by peteridah on Friday April 12, 2013 @11:14AM (#5538924)
For someone like me with relatively new django skills, I felt the book gave me a very good feel for best practices used in the community; I feel the authors did a good balancing act of informing readers of the best options available while being firmly opinionated where necessary.
Re:Two Scoops of Django final edition released by LVB on Friday April 12, 2013 @11:33AM (#5539042)
The opinions are what set it apart. I'm one who, when new to a topic, can quickly end up in a deer-in-the-headlights state if faced with a large number of competing approaches. I spend too much time flip-flopping and second guessing until I build some history with whatever it is I'm working on.

The Two Scoops approach is: we're two Django developers with a lot of experience, and here's our approach that has been successful which you can use. They go so far as to say, "you may hear about x/y/z, but here's why you can safely ignore that in almost all cases..." Works very well for me.

Re:Two Scoops of Django final edition released by shavenwarthog2 on Friday April 12, 2013 @01:42PM (#5539952)
I started a job recently that relied on much more Django skills than I had. I'm a senior programmer, but my Django was dusty. Purchasing "Two Scoops of Django" was a fantastic investment. The material is moderately dense, giving "best practices" to a wide range of practical topics.

For me, a technical "here's what's really important" book is the most valuable. Django docs (and the Django Book) are great, and I'm thrilled to have them plus "Two Scoops" to use for my day job.

Re:Two Scoops of Django final edition released by thatthatis on Friday April 12, 2013 @12:48PM (#5539606)
Same thing I said in another thread, but it is relevant here too:

Books like this should really offer a money back guarantee.

Why? It signals quality and enables speculative purchasing.

The quality signal I think is obvious.

The speculative purchasing is an incremental sale. Emotionally, I'm not going to purchase this book without a guarantee unless I've decided to commit time to read it. However, with a guarantee I can buy it on the chance that I might read it. It's not logical, I know, but it is how customers work emotionally.

Also, economically your guarantee is basically free. 99% of the time its not worth my time to request the refund even if I don't like the book. The 1% is if your book has made me emotionally angry due to its poor content (1 book I've ever read).

But, people will game the system? No they won't. At least not in sufficient volume to make it worth worrying about. If I want to scam a free copy of your book, it's likely I can find a pirated version faster than I can get my wallet and enter my credit card number.

Re:Two Scoops of Django final edition released by rubinelli on Friday April 12, 2013 @12:59PM (#5539686)
And here's the clincher: the buyer already has the ability to ask for a refund from Gumroad or a credit card chargeback. Those who really want their money back will get it anyway.
Re:Two Scoops of Django final edition released by pydanny on Friday April 12, 2013 @03:17PM (#5540472)
Please, please, please don't ever do credit card chargebacks. Merchants get charged nasty fees each time that happens.
Re:Two Scoops of Django final edition released by thatthatis on Friday April 12, 2013 @01:10PM (#5539756)
I didn't realize that there was a built in gumroad refund policy.

Charge backs in that case are sleazy.

Re:Two Scoops of Django final edition released by pydanny on Friday April 12, 2013 @02:39PM (#5540289)
Honestly, we didn't put in a refund statement because until we read this post of yours, we never thought about it. Thanks for the suggestion.
Re:Two Scoops of Django final edition released by thatthatis on Friday April 12, 2013 @03:00PM (#5540389)
Which is why I posted this -- I've seen the effect of a guarantee on sales and profit for a number of products, and the data I've seen suggests it would increase your revenue and profit.
Re:Two Scoops of Django final edition released by Myrmornis on Friday April 12, 2013 @11:39AM (#5539085)
Looks great, will buy. This is not a criticism of this book: does anyone have a hack to add syntax highlighting to any of the ebook formats? I understand why colored syntax highlighting isn't provided in paper formats, but I don't understand why publishers don't use it in ebooks on programming.
Re:Two Scoops of Django final edition released by __mharrison__ on Friday April 12, 2013 @11:59AM (#5539224)
It doesn't have to be a "hack". Most modern devices would support it just fine. The main problem is the older kindle devices that only support the mobi7 format.

An author is likely to get dinged on reviews if formatting on older eink devices is poor. So in practice the lowest common denominator wins out...

Re:Two Scoops of Django final edition released by pydanny on Friday April 12, 2013 @02:40PM (#5540296)
You're right. We took it out because it looked awful on certain devices.
Re:Two Scoops of Django final edition released by khalstvedt on Friday April 12, 2013 @11:49AM (#5539157)
Some do, I know at least http://pragprog.com/

A hack to parse and add to existing ebooks would be quite handy, though.

Re:Two Scoops of Django final edition released by famousactress on Friday April 12, 2013 @11:44AM (#5539122)
A hack for adding it sounds like such a clever idea! I'd love that.
Re:Two Scoops of Django final edition released by neokya on Friday April 12, 2013 @09:34AM (#5538336)
We purchased this in initial release. This is good book, fills the gap between developers and documentation.
Re:Two Scoops of Django final edition released by tterrace on Friday April 12, 2013 @03:40PM (#5540584)
Last time I used Django, I loved everything except class based views. I thought my view code was much clearer and easier to work with after I switched to FBV's. I see the book touches on both methods, but overall is it opinionated one way or the other?
Re:Two Scoops of Django final edition released by jimray on Friday April 12, 2013 @04:22PM (#5540776)
Yes. The authors like CBV's and make a strong case for why you would want to use them.

Like you, I found CBV's to be wanting, particularly generic views, and all but gave up. A combination of updates to the official docs with 1.5 and this book made me reconsider and I'm glad I did.

Re:Two Scoops of Django final edition released by tterrace on Friday April 12, 2013 @07:48PM (#5541838)
Thanks for the info, I'll probably give them another shot in my next project after I go through the book.
Re:Two Scoops of Django final edition released by mladenkovacevic on Friday April 12, 2013 @10:05AM (#5538517)
Thank you for the EPUB version!
Re:Two Scoops of Django final edition released by anderspetersson on Friday April 12, 2013 @05:50AM (#5537486)
I bought and read the beta, will read it again now that the final version is out.
Re:Two Scoops of Django final edition released by mcintyre1994 on Friday April 12, 2013 @06:11PM (#5541388)
As a student looking to do some work with Django, this is going to be invaluable! Huge thanks, I've been looking for exactly this since I finished the beginner tutorial!
Re:Two Scoops of Django final edition released by emperorcezar on Friday April 12, 2013 @07:31PM (#5541746)
This book's meer existence has made my team's code better. Thank you.