Ever since LabVIEW 8.0 released, several LabVIEW developers have been making trips to present at NI Technical Symposiums about the release. It's customary for the developers to write up trip reports when they get back so those of us who stayed in
Here's a bit from one such trip report:
I had a customer…come up to me after the…keynote…He had just bought LabVIEW 7.1 and gotten the upgrade to LabVIEW 8.0. He was having a hard time figuring out how to do event-driven programming in LabVIEW. I guess the AEs had tried to lead him to training courses. He was visibly upset that he'd spent all this money on the software, the manuals didn't teach him how to use the product, and now we were trying to extract more money out of him for training. Digging a little bit deeper, he's getting confused by various inconsistencies in terminology, and a general lack of "how-to" documentation around some of our bigger features…[Customers] feel pain when we're not able to devote sufficient time and resources to our documentation.
Now if you've seen the LabVIEW 8.0 Upgrade Notes, you know LabVIEW 8.0 is chock full of features and enhancements—it took over 75 pages just to list them all. It was certainly challenging to provide complete documentation for that many features and changes. In fact, if you look closely at the LabVIEW 8.0 Help, you'll notice a section in the Contents tab called "Miscellaneous Features and Changes," which has the following introduction:
This book contains step-by-step instructions and conceptual information about a small subset of LabVIEW 8.0 features and changes. In a future release of LabVIEW, this information will move to the Fundamentals book in the Contents tab.
So you can probably infer that we weren't able to devote the time and resources to those "miscellaneous" features that we would have preferred. That one book in the LabVIEW 8.0 Help is pretty much the only place those features were documented. For example, if you navigate in the Contents tab to the Fundamentals»Graphs and Charts»Concepts book, you won't find any mention of the new mixed signal graph in the topic titled "Types of Graphs and Charts."
We're already working on revisiting those "miscellaneous" features for a future release of LabVIEW documentation. But the question I struggle with is this: How much damage have we done to our users' trust in the LabVIEW documentation with that "Miscellaneous Features and Changes" book? If the mixed signal graph is one of the main reasons a user bought LabVIEW 8.0 and the LabVIEW Help has very little information about it, how likely is that user to refer to the LabVIEW Help again?
And when customers do feel that pain, as with the events documentation, what can we do to gain their trust again? We'll certainly record the issues reported and look into them for a future release of LabVIEW, but will that be enough?