“Now what?” is that uncharted territory between “Getting Started” product guides and the challenge of incorporating a new tool into day-to-day activities.
In fact, I’m convinced that “Now what?” is one of many creatures inferred by the “Here be monsters” legend inscribed on uncharted regions of old nautical maps.
I think of it like this: You buy an exciting adventure package to Costa Rica. You put your money down. The tour operator hands you a map. And then you end up…in Holland.
Time to call your emergency number:
You: “Can you help me out? I was supposed to go to Costa Rica and I followed the directions, but I’m in Holland.
Customer support: “Let’s go over what happened and take a look at the directions.”
Customer support reviews your actions and examines the map. (They are incredibly patient, discerning and resilient people, these customer support types.)
Customer support: “It appears that you took a wrong turn at Albuquerque (except it’s pronounced Albekoiky).”
Then you’re put on the right road. A problem report gets logged against the map-makers to clear up whatever ambiguity there was. Now you and future travelers can end up at the intended destination.
“Okay. I’m in Costa Rica. Now what?”
This is an issue sales engineers frequently encounter in the field. It is also something that Geoff Babb touched on in his response to Helen’s post, “Exposing our soft underbellies“, about moving documentation to a wiki.
Useful examples are great, but finding the right scenario can be difficult, particularly when customers can range from a couple of guys in their basements to companies with thousands of developers.
With a large documentation set, it’s difficult to keep up with new features and include scenarios that are relevant to everyone—a major rewriting effort indeed.
During a meeting where we presented our documentation plan for moving to a wiki, “Now what?” showed up again.
I don’t remember putting “Now what?” on the list of invitees. But it appears that there’s no stopping that beast.
Our move to a wiki means rewriting a helluva lot of material anyway. Might as well take on the beast.