You know its Christmas because Packt are running their all ebooks for $5 promotion. Including those I have co-authord and even the ones we’re working on at present.
Our books …
We have just supplied our publisher with the final draft of the final chapter in our book about Oracle Integration Cloud Service (ICS). Before we get too chilled out waiting to see the printed article as Packt Sort out the final publishing I thought it might be helpful to share some observations from our experiences.
Let’s start with some background. I have been acting as a peer reviewer for Packt for some years now, and in fact Packt had approached me in the past to write a book, however I had declined their proposals as I didn’t want to write on a subject that people had already written about. So when I was introduced to ICS, this felt like a good subject to write a book on, certainly represents something that it is going to have a significant future and deserved a book to help people get beyond a basic user guide.
Choosing to write a book is not a small undertaking, so make sure you’re going to do this for the right reasons. Let’s be honest, very few books make much money. You have to be lucky, writing a subject you know us going to be game changing (think Gang of Four and Thomas Erl) or have a definitive text on the next big thing that everyone will use. Publishers also run promotions, discounts and give aways, some more than others, but that will all eat into you share, not to mention unless you self publish or you’re a rock star author you will not see big percentage royalty rates coming your way.
So first steps, for us was to get a publisher on board, given it was an Oracle product I wanted to talk to Oracle Press (or here) first which is run by McGraw-Hill. They weren’t too sure about the idea, having not been successful with previous cloud books. So we went back to Packt, they do have Oracle based books, and I had a relationship there.
With some initial positive feedback, I needed to get things moving. Thinking through this I concluded that the entire book alone could be a lot of very hard graft when working with a new product and I didn’t have the access to the same level of resources working for a customer organisation as you can with an Oracle partner company. So I needed a co-author who was involved with ICS, and ideally working for an Oracle partner. I had seen Robert van Mölken blogging about ICS, and working for AMIS suggested he would be a very capable person, not to mention AMIS is a respected partner. Robert has shown himself to be more than capable, and getting him signed up to the idea was a good call.
Next, was to start properly developing the idea, which means chapters, subheadings, and book introduction. Very quickly the chapters and subsections where finalised, along with our approach to the examples. I was very keen that the examples where routed in plausible scenarios and that would help the ideas without getting caught up explaining the detail. Not to mention the examples should feel less superficial. Additionally, we have recognised that a book about a cloud solution means that things will move far faster than something that is deployed on-premises, so how we approach this book needs to hold true and relevant even if there are new features and aesthetic changes for a good while.
We divided the work up between us, I think Robert in hindsight took on the more troublesome chapters, in so far needing to understand more social APIs. So when plotting out the division of work, also think about the technical challenges you might have and need to explain. Whilst you won’t have this in perhaps a ‘hello world’ level of functionality when you past this effort builds up, if you’re working on a cookbook it may we’ll be an important factor.
Our original goal had been to publish in time for Open World. But the realities of a job, both of us being active with events such as user groups meant these things would eat into the available writing time as demos, presentations would also need to be written. We also uncovered a couple of bugs that delayed things, both in waiting for the patch, but also confirming that what we where seeing was a bug, and not an issue of understanding.
In hindsight I think perhaps we should have done more work during the planning to build the example scenarios. There is no doubt that planning before actually writing makes a significant difference. It would have given us more time in working through the questions and challenges. The risk would have been that it would have been a lot longer before we actually produced some content, and there is certainly something psychological about getting those initial chapters written.
During the core writing phase Robert and I would gave weekly call to catchup, it meant that we could discuss the chapter scenarios, details, and assumptions that meant we were aligned. Whilst not necessary, and this could be done be email, a short conversation was a lot easier and it helped keep focus. Not to mention probably reduced the differences in writing that can occur with different authors.
When comes to the writing itself I found the clearer my thinking was on the specific points I wanted to convey the easier the writing became and the writing of the chapter just flowed. The question I still haven’t really answered in my own mind is whether I should have been a lot more attentive to the formatting the publishers wanted us to adopt, applying it retrospectively took a couple of passes as you would spot something that had omitted the correct style. But diligently applying the right styles would have been disruptive to the writing style.
We found that most chapters overran the page count by about 10%-15% the publisher was pretty cool about this – they definitely agreed a good book over a book that was edited to a specific length was most important. We can put the over run down largely to the fact we didn’t allow for the formatting of the page, which meant more white space that we had anticipated, plus in the drafts we needed to put additional publication notes in such as references to the images being used. It is worth looking at this before finalising your chapter lengths.
The last thing we did during the writing of the 1st drafts was reviewing each other’s work before submitting the chapters. This probably helped a lot in so far as Robert would often pickup on issues with my screenshots and I would tend to finesse wording – when you write in a more conversational style those little quirks of speaking can come through.
Completing all the chapters in 1st draft felt pretty satisfying, and certainly a morale boost as we had overrun our original estimates, as it meant we where we we’re well over 50% complete, probably nearer to 75% complete in terms of effort. In the contract with Packt this was also the 1st milestone for the advance, which is a long way into the process and the payment has yet to be received. Some of this delay has been organisational, but things don’t happen quickly on that front.
Before we started the project one of the Oracle Ace Directors we knew provided some observations, suggesting that each page will probably take a couple of hours to write. I have to admit to being a little sceptical of this as it would mean roughly a year of writing every evening for both of us if you look at it from an elapsed time it isn’t so far from the truth. If you look at the actual effort, those weeks where I was just working on the book rather than presentations or work demands. I think it would have been fair to suggest about 8-12 hours of effort went into the book each week which is about 450 pages in length. In the end I think we probably where writing at twice that speed if you measure effort from 1st to last draft.
Second draft is about addressing the review feedback from the peer reviewers. For us that was pretty straight forward,the feedback we received was very positive and making suggestions on how to improve things. As we wrote about a cloud product that is developing and improving quickly we needed to double check the screens hadn’t changed. We did see 1 challenge in the reviewing. We wrote the Preface to help provide context to the book, but I didn’t get sent before the 1st chapters went to review some comments as a result perhaps weren’t so intune with the books underpinning goals. Should the reviewer need to have had the preface first, debatable. We took advantage of this lesson, to reduce the dependency on having read the preface.
Most changes where about fixing formatting, then adding a couple of additional screenshots and some clarifying text. Each chapter probably only needed 1 additional paragraph per chapter. So working through this was pretty quick. Then it has been over to the publisher to finishing things off and assemble the book.
Going forward, we will continue to write additional material, initially for the blog (oracle-integration.cloud) but we are exploring the idea of a living book where the book version will undergo quarterly updates. But time will tell as to whether this makes a difference.
The book can be found at:
I received an email through the virtual Java User Group highlighting the availability of a couple of eBooks around Java published by O’Reilly. The details are below. The books are more booklets (nothing wrong with that). The key difference being that they are shorter and focused on one or two focused subjects (in this case Java 8’s Lambda’s & Streams) which is great because I don’t want a whole Java book again, I just want to get a handle on the key changes and language innovations. It is worth highlighting that these aren’t just ‘free chapters’ which is what you see happen sometimes as the goal of the book is described, doesn’t depend on prior chapters to work the illustrated material and structured with the appropriate cover material contents, index etc so works as a discrete entity.
This approach seems to be coming more common at O’Reilly at least as a marketing device, and we have seen this being done with the Dummies brand where the booklets have then been printed as conference give aways.
Some may argue that this is a reflection of our ever shortening attention span with books. This maybe the case for some, but I suspect it is more about providing some that is more digestible than a ‘free chapter’, but more importantly reflects the recognition that for books that are providing guides (as opposed to reference books – which I’d include patterns books) people don’t want to buy a latest edition of a book where the 1st chapters are exactly the same as the previous edition of the book and that the only significant change is a new section on Lambdas for example.
Any way the latest book details received are:
by Raoul-Gabriel UrmaOffers a practical tutorial to some of the core Java 8 features and gets you programming quickly with Java 8.by Richard WarburtonExplains the similarities and differences between functional programming and object oriented programming with Java focused examples.
The other book(lets) that have drawn my attention to the trend include:
In addition to these Book(let)s O’Reilly offer a range of ‘reports’ such as:
In addition O’Reilly have a page on ‘Open Books’ (here) – covering significant texts O’Reilly have had some involvement in but published under licenses such as Create Commons.
I have just been told that the 2nd Edition of Java EE Development with Eclipse has now been published. This is another book that I have supported as a technical reviewer. Looking forward to receiving my print copy so I can see how my suggestions and feedback have carried through to the final copy.
You can see the book on the Packt site with https://www.packtpub.com/application-development/java-ee-development-eclipse-second-edition or Amazon here
Here is the finished article!
It seems to becoming the done thing to license the use of the ‘For Dummies’ brand and publishing books (or are they large booklets) on a specific subject. These can then often be picked up as print freebies at conferences. I saw a couple at the Oracle Cloud Event today – though I’d share the ebook versions here:
Might be a little early for Packt, but I have completed reviewing the 2nd Edition of Java EE with Eclipse for Packt now. So the book should be available in the next couple of months.
On the subject of Packt, the Free Learning scheme they are running continues. I’ve seen a couple of books repair since the start of the promotion. But for main part each day is new and different and covers a wide range of things from JQuery and Node, to Hadoop and into Drupal and WordPress. So worth checking back on a daily basis.
All of this means time to do some more Oracle writing.
Designers must understand user needs to create any product. But what type of data should you look at?While we’ve all heard about big data, talk of “thick” data remains scant. Generally speaking, big data is quantitative; it gives you the what, where, and when, while thick data provides the qualitative perspective—the how and the why.
Pamela Pavliscak, founder of design research firm Change Sciences, says you need all the data—both big and thick—to fully understand how users interact with websites, apps, and other products. In her new report, Data-Informed Product Design, she outlines a way to use data of all kinds to understand the relationship between people and technology.
Up until now, there hasn’t been much information on how to combine quantitative big data with qualitative thick data. That’s where this report can help. If you’re involved in any aspect of product design, this is indispensable reading. It’s useful, and we’re pleased to offer it to you, for free!
Packt are repeating the promotion that they ran earlier in the year where each day they give away a free ebook. The books so far are (at least from my perspective) a little niche – developing for Kinect for example. Go check it out each day until the 17th you might see something that works for you.