Blog of Chat

Also see: Cool Silverlight Momentum Video Posted

Well, apparently you aren’t allowed to have an opinion on the web anymore. I got flamed by an author after posting a personal review of his book. It wasn’t an objective review, I didn’t mark it as such, but I wasted a good deal of my life between reading the book and then turn that around with the extra hour I spent writing the review so I figured I’d put my real thoughts in there. Anyway, seems the author had some comments.

Guess what? Authors need to learn that not everyone can write a book. I don’t care how technically able you are, how smart, or how much of an industry professional. I don’t care if you’ve been writing X for Y years where Y > Z and Z is my age… Just because you’ve been working on technology since before I was born doesn’t mean you have the ability to produce a book that is able to capture a wide audience and instruct them in a given area. I’ll throw some points to back this up.

Microsoft Windows is a great piece of software and some insanely talented developers wrote the OS. But guess who wrote the documentation? Sure as hell wasn’t the people that wrote the OS. What about the CLR? Super smart people doing super smart things over there. But how many of them dare write a book about it? Adam Nathan did a great job, but I think he took more than a year writing his. What about Brad Abarams and the annotated CLR? Well, that isn’t a book of explanation but rather a book of comments that was very tactfully edited. The people that really write about the CLR are the tech writers that produced the oh so complained about.NET Framework SDK Documentation. If you think it’s bad now, you wouldn’t want to know what it would look like if there wasn’t a dedicated team of technical writers with English degrees working on it.

You see, just being an expert isn’t a license to write a book. You have to take many considerations into play. You have to design content around your audience, get down off of your soap-box, and explain things in a detail that your readership will comprehend and gain value from. It appears Edward doesn’t agree with me. I pointed out that I got nothing from the text of his book, but then he points me to the free source code download. I already knew about the download and had perused the source before and after posting the original review, but I don’t think that is important or relevant. When you buy a book, you are buying the material that you can read while you are in a bus, in your car, on a plane, while you are walking down the hall, or if nature calls on the toilet. You really aren’t paying for the source code. The source code is an extra in the world of publishing. It is nice if the readers make use of it, but you want to provide everything in the text if you can. Popping between book and source is annoying, and even worse, nearly impossible when the book and source aren’t logically connected.

Also see: Be my Support Group

Also see: Dare Obasanjo on C# Anonymous Types

Also see: Java Concurrency, another series on its issues

Also see: Infrequent blogging

Raise of hands, if I gave you a 65k file whose name was Form1.vb and I told you the compiled program would represent a rather complex regular expression validating GUI called ReLab, what would you do? How easy would it be to quickly find the information you needed in that file? Would you even bother trying to understand the behemoth? What if the text of the book didn’t tell you about the code itself, but rather about the program and how it worked? What if they just gave you a bunch of pictures of the UI and some walk-throughs of how it would work? What would you say the target audience is when the book is filled with pictures and there is a huge backing source repository that contains almost no explanation?

You don’t have to answer all that if you don’t want, but I’m interested in what you have to say. Good or bad, wrong or right, I don’t care, because this is MY opinion, but I’m interested in everyone else’s opinion. I’m tired of paying 40-60 bucks for a book that doesn’t stand on it’s own merit. If the source is really what I’m buying then why give it away for free here http://www.apress.com/book/supplementDownload.html?bID=213&sID=1895. What in the hell would I buy the book if everything important is in the source code shown here http://www.apress.com/book/supplementDownload.html?bID=213&sID=1895. Go ahead, download it and check it out. It isn’t easy to digest by any means, and the book itself won’t help you at all.

Edward is taking this as a personal attack, but everyone that knows me knows better. I buy a book a week at least. Some are great, some are mediocre, but I never, ever buy the bad books. I invalidate them during my initial review process and I rely on my professional insight to quickly spot and discredit the bad ones. I don’t always take the time to give those I’ve spotted a shining review on my blog, but there are certain things that really get my goat and this was obviously one of them. You can’t ask for just good reviews as an author. When was the last time a movie released with not a single bad review somewhere on the web or published in some newspaper? But, “Oh”, the actor says, “You’d like the movie better if you understood how many shots it took for that scene you didn’t like and the technical difficulties behind it”… In reality, I don’t care if it took them 1 shot or 50 shots, I don’t care if the author produces 1 line of code or 50 thousand lines of code. I see the end result, I see what I read, and I’m going to rely on perusal process within the bookstore before deciding to buy. If you aren’t going to give me the material in your book to enable that process, then I’m not going to buy your book, AND I’ll post an honestly bad review.

Also see: From C# to Java: Part 3

Also see: Degrees of optimism in projects

Also see: My Presidential Endorsement:

Anyway, I responded to Edwards comments, and put my own right after. I’m sure the comment space will get heated if you are into that. In conclusion, don’t put your heart and soul into a book and then get all parental when someone doesn’t like it. If you can’t take the criticisms, then you shouldn’t be publishing. Build on it, forget about it, discount it, do whatever you must, but don’t whine and use political bullshit to try and get me to take my criticisms down.