I promised a story about the dangers of trusting vendors to create specifications. This is that story.
There once was, and still is, a Gigantic New York Publisher (which for lawsuit avoidance will remain nameless). This publisher wanted to do OEB ebooks, but found the back-end conversion process that led to OEB rather daunting, given the variability in typesetting workflows and resulting file quality they had to deal with. Quite understandable.
So they threw millions of bucks at a Gigantic Consultancy Outfit (also nameless, for similar reasons, but I still have the business card of the project manager on this job) to write them a house Quark stylesheet (not a house design, to be clear, just a set of style-naming conventions) and a related OEB XML spec. It so happened they asked me whether a house stylesheet and XML spec was a good idea. I told them yes, it was, because it is. But there were things about the project I didn’t know…
Amount of typesetting experience this Gigantic Consultancy Outfit boasted? None. Amount of markup experience? None. Amount of OEB experience? Big zero. Why was this outfit hired, especially for such incredible amounts of money, when there are plenty of people around with either typesetting or markup experience—and a few with both—who charge orders of magnitude less for something of this nature? Heck if I know. I suspect it was a nobody-goes-wrong-buying-Microsoft thing.
How much in-house typesetting experience did the publisher have? None. (At least, none that I ever saw or heard about.) They’d outsourced all their typesetting long since. How much in-house markup experience? None, though they were making incredibly feeble and inadequate baby steps toward developing some. (To the best of my knowledge, some five years later they still haven’t succeeded.) OEB experience? Well, they were involved with the OEBPS working group, if by “involved” you mean “a person with no technical expertise and nothing to contribute silently attending conference calls and meetings.” That was it.
Trainwreck waiting to happen.
I did not run into the resulting spec until a year or so after it went into the field. If you dig far enough into CavLec archives, you can find a complaint or two about it, and one outright rant after a day of utter frustration.
Because the spec was rot. Unusable garbage. It did not and could not work as a typesetting spec; the publisher complained in my hearing that “we can’t get our typesetters to adhere to it!” without once (as far as I ever heard) considering that the problem might not rest with the typesetters. As an XML spec, it was barely functional in some areas, but broke down completely several times, mostly because nobody at the publisher or the consultancy outfit grokked the concept of markup hierarchy. As I wrote then:
One very large, very important publisher, whose name I will not mention because I am allergic to litigation, tried to wish [the problem of typesetting multiple-paragraph structures such as lists] away by pretending that in the total absence of hierarchy, any given type of list only needs one list item tag. The lame pretense is enabled (in the sense that one enables another’s addiction) by specific tags for extra line spacing, which is an abomination unto the fair names of typesetting and markup alike.
Being the kind and helpful person I am (stop laughing!), I wrote out the clearest explanation I could of where the spec had gone wrong and specifically how to fix it, and submitted it to my higher-ups so that they could give it to the publisher. For FREE, mind you, and unsolicited. I wasn’t interested in getting money for my work; if my higher-ups wanted to extort money from the publisher, that was fine, but I didn’t care. I just wanted the damnable spec fixed so that I could work with it without feeling dirty about the crap markup it forced me to eject.
My higher-ups quashed my report, all the way to the very top of the company I worked for. In fact, my coworkers and I were forbidden from giving the publisher any feedback at all on the spec. We don’t dare show up this publisher; they’re too important a client, I was told. We’ll look arrogant, saying we know more about markup and typesetting than they do.
Well, we did—at least, I did! And in fairness, so did one or two of my coworkers. The whole experience was a real eye-opener for me. I had been hired (I thought) for my markup expertise; I couldn’t fathom why it wasn’t being used to good purpose.
Eh, well. Be that as it may, the publisher never saw that report, though it did inform an article I wrote shortly thereafter. I doubt they ever got their spec fixed. All their millions of dollars bought them was a junk spec, a lot of useless markup tied to the junk spec, and a boatload of angry, frustrated typesetting contractors.
This is not to say that the consultancy outfit knowingly or wilfully delivered a garbage spec. I firmly believe they did their best with their limited knowledge. They just didn’t know what they were doing, and the publisher did not have and did not hire the expertise to catch their errors.
Know what you’re doing before you outsource. Please. Even your vendors—those that aren’t exploitative, clueless, or both, anyway—will thank you.