I am stunned. Utterly stunned. In fact, I was so stunned when I first saw this that I was actually lost for words, briefly.
Never in all these years have I seen a document so badly written. It’s one thing to lack polish and finish, it’s quite another to marry awkward incoherent embarrassing style with obscene content, and have the gall to claim it’s some kind of technical document. Not even the early jboss group made-in-india manuals come close to this abysmal quality.
So, what is this inspired work of under-appreciated genius? It’s the first two draft chapters for the Geronimo developer notebook (you can find them on today.java.net).
Where does one start, really? Perhaps some choice quotes to help set the mood.
- but it’s no worse than those movies with flying cars that take place only 20 years in the future (Page 1)
- It’s also a poor excuse to make a reference to the geek-bible, The Hitchhiker’s Guide to the Galaxy. (Page 1)
- … and tons of text will scroll by (Page 2)
- Now take out your number 2 pencil and write down the complete path to that directory (Page 2)
- Give yourself a pat on the back. (Page 2)
- Maven is a pretty exciting piece of software (Page 2)
- If you are in Windows, you can easily use WinZip to extract the file (Page 3)
- CVS is older that the hills in terms of open source software, so we are going to assume basic CVS knowledge in this section. (Page 5)
- Good patches have been known to get you a free beer or two and some time with the developers at any of the conferences we speak at (Page 5)
- Downloading the dependencies is unavoidable (Page 6)
- Jane, stop this crazy thing! (Page 10)
- get your number 2 pencil ready then jump back (Page 10)
- The test suite should be gloriously piling dots down your screen (Page 12)
- Oh the beautiful dots of JUnit test cases (Page 12)
- The rest of the examples in this book all use Maven. Trust me, it is a lot simpler. (page 13)
This is all chapter 1. Chapter 2 is more (and often much worse) of the same.
The maven obsession is rather troubling. It’s almost as if the author had just recently discovered it, and is, at the time of writing, blissfully unaware of any of its downsides. For one thing, he’s very big on remote repositories, whereas conventional wisdom would state that the ‘right’ way to use maven is with a local repository. As if that wasn’t offensive enough, he frequently just loses the plot altogether and proclaims how exciting it all is, and gets sidetracked gushing about maven for no reason whatsoever.
Now, I realise that the purpose of these O’Reilly developer notebooks is to be friendly and casual, but really, in this case it’s downright offensive. We have references to Johnny Carson, noting things down with pencils, jokes that fall flat and elicit nothing more than a wince or grimace at best.
There’s a huge difference between being engaging and informal and talking down to people like a bizarroworld mixture of American pop culture, idiot grinning, and condescending twatiness. These chapters seem to largely ignore that difference, sadly.
Setting aside the obscene tone of the whole thing, and how every single sentence is in need of some very serious editing, the actual content itself is abysmal.
For example, in one chapter we’re told that there are no deployment tools because the Geronimo folk take security very seriously, and those pieces aren’t done yet. Yet, shortly after that our dear author starts cooing and oohing at the fact that Geronimo can download random wars off the internet and install them.
I am also unable to decipher who the target audience for this monstrosity is. Is it totally clueless developers, who need to be told to use winzip to unpack files? Is it pretentious but spastic opensores fucktards, who know all about CVS but need to be hand-held through setting environment variables? Is it average Americans in the midwest who can only relate to things through TV references? The only conclusion I’m forced to draw from the content is that the chapters are not aimed at all. Someone just thrashed about wildly in the vicinity of a keyboard and hoped for the best, which is far, far, from good enough.
Perhaps this is why O’Reilly is such a prestigious publisher. They have the uncanny ability to turn absolutely worthless incomprehensible frothing drivel into something mildly inoffensive. Hats off to them if they manage to salvage anything out of this train-wreck though.
Fleurites rest easy, you have nothing to worry about it.