#Rev - 20200720 google.com, pub-2035719743358482, DIRECT, f08c47fec0942fa0 #WordPress pubmine.com, 18134866, DIRECT google.com, pub-2035719743358482, DIRECT, f08c47fec0942fa0 #WordPress - Google google.com, pub-3443918307802676, DIRECT, f08c47fec0942fa0 google.com, pub-8101658338626046, DIRECT, f08c47fec0942fa0 google.com, pub-6245772903043650, DIRECT, f08c47fec0942fa0 google.com, pub-2035719743358482, DIRECT, f08c47fec0942fa0 #WordPress - AppNexus appnexus.com, 7766, DIRECT #WordPress - Pubmatic pubmatic.com, 156204, DIRECT, 5d62403b186f2ace #WordPress - Oath Display adtech.com, 9534, DIRECT, e1a5b5b6e3255540 adtech.com, 12089, DIRECT coxmt.com, 2000067907202, RESELLER pubmatic.com, 156078, RESELLER, 5d62403b186f2ace openx.com, 537143344, RESELLER, 6a698e2ec38604c6 indexexchange.com, 175407, RESELLER, 50b1c356f2c5c8fc yahoo.com, 1705067, DIRECT #WordPress - Oath Video advertising.com, 24010, DIRECT #WordPress - Oath One Mobile aol.com, 47425, DIRECT openx.com, 537126269, RESELLER, 6a698e2ec38604c6 pubmatic.com, 156138, RESELLER coxmt.com, 2000067997102, RESELLER indexexchange.com, 184110, RESELLER, 50b1c356f2c5c8fc advertising.com, 28319, DIRECT, e1a5b5b6e3255540 yahoo.com, 47425, DIRECT, e1a5b5b6e3255540 #WordPress - Amazon aps.amazon.com, 6fb17607-32fb-47ed-b920-df44722f6475, DIRECT openx.com, 540191398, RESELLER, 6a698e2ec38604c6 pubmatic.com, 157150, RESELLER, 5d62403b186f2ace districtm.io, 100962, RESELLER appnexus.com, 1908, RESELLER, f5ab79cb980f11d1 yldbt.com, 5b522cc167f6b300b89dc6d3, RESELLER, cd184cb30abaabb5 coxmt.com, 2000068024302, RESELLER rubiconproject.com, 18020, RESELLER, 0bfd66d529a55807 adtech.com, 12068, RESELLER, e1a5b5b6e3255540 rhythmone.com, 1654642120, RESELLER, a670c89d4a324e47 #WordPress - BSW - Grid themediagrid.com,9CPDN6,DIRECT,35d5010d7789b49d #WordPress - FreeWheel #FreeWheel - Free (non-wordpress.com domains) freewheel.tv, 707442, DIRECT freewheel.tv, 707874, DIRECT #FreeWheel - Premium (non-wordpress.com domains) freewheel.tv, 707458, DIRECT freewheel.tv, 707890, DIRECT #FreeWheel - Advertising (wordpress.com domains) freewheel.tv, 824865, DIRECT freewheel.tv, 824881, DIRECT #FreeWheel - Alcohol Ads (wordpress.com domains) freewheel.tv, 824897, DIRECT freewheel.tv, 824913, DIRECT #FreeWheel - Animals (wordpress.com domains) freewheel.tv, 824929, DIRECT freewheel.tv, 824945, DIRECT #FreeWheel - Books and Literature (wordpress.com domains) freewheel.tv, 827905, DIRECT freewheel.tv, 827921, DIRECT #FreeWheel - DIY Projects (wordpress.com domains) freewheel.tv, 827937, DIRECT freewheel.tv, 827953, DIRECT #FreeWheel - Finance (wordpress.com domains) freewheel.tv, 827969, DIRECT freewheel.tv, 827985, DIRECT #FreeWheel - Fitness (wordpress.com domains) freewheel.tv, 828001, DIRECT freewheel.tv, 828033, DIRECT #FreeWheel - Food (wordpress.com domains) freewheel.tv, 828049, DIRECT freewheel.tv, 828081, DIRECT #FreeWheel - Hobbies (wordpress.com domains) freewheel.tv, 828097, DIRECT freewheel.tv, 828113, DIRECT #FreeWheel - Legal Issues (wordpress.com domains) freewheel.tv, 828129, DIRECT freewheel.tv, 828145, DIRECT #FreeWheel - Music (wordpress.com domains) freewheel.tv, 828161, DIRECT freewheel.tv, 828177, DIRECT #FreeWheel - Other (wordpress.com domains) freewheel.tv, 828193, DIRECT freewheel.tv, 828209, DIRECT #FreeWheel - Parenting (wordpress.com domains) freewheel.tv, 828225, DIRECT freewheel.tv, 828241, DIRECT #FreeWheel - Photography (wordpress.com domains) freewheel.tv, 828257, DIRECT freewheel.tv, 828273, DIRECT #FreeWheel - Religion and Spirituality (wordpress.com domains) freewheel.tv, 828289, DIRECT freewheel.tv, 828305, DIRECT #FreeWheel - Sports (wordpress.com domains) freewheel.tv, 828321, DIRECT freewheel.tv, 828337, DIRECT #FreeWheel - Technology (wordpress.com domains) freewheel.tv, 828353, DIRECT freewheel.tv, 828369, DIRECT #FreeWheel - Travel (wordpress.com domains) freewheel.tv, 828385, DIRECT freewheel.tv, 828401, DIRECT #WordPress - Media.net media.net, 8CU8HDVRS, DIRECT sonobi.com, 83729e979b, RESELLER coxmt.com, 2000068030802, RESELLER districtm.io, 100600, RESELLER appnexus.com, 1908, RESELLER, f5ab79cb980f11d1 pubmatic.com, 157291, RESELLER, 5d62403b186f2ace rubiconproject.com, 17054, RESELLER, 0bfd66d529a55807 openx.com, 537100188, RESELLER, 6a698e2ec38604c6 rhythmone.com, 3611299104, RESELLER openx.com, 537100188, RESELLER, 6a698e2ec38604c6 adyoulike.com, c4bf4fdd9b0b915f746f6747ff432bde, RESELLER, 4ad745ead2958bf7 #WordPress - Polymorph getpolymorph.com, 2338, DIRECT, d444e922d4e4d6e2 adsnative.com, 2338, DIRECT, d444e922d4e4d6e2 appnexus.com, 7614, RESELLER, f5ab79cb980f11d1 rubiconproject.com, 16596, RESELLER, 0bfd66d529a55807 pubmatic.com, 156057, RESELLER #WordPress - Rubicon rubiconproject.com, 18894, DIRECT, 0bfd66d529a55807 #WordPress - Teads teads.tv, 6977, DIRECT, 15a9c44f6d26cbe1 #WordPress - Adyoulike adyoulike.com, 898fc1202d7e525263488c125d35c8ef, DIRECT, 4ad745ead2958bf7 #WordPress – 33across 33across.com, 0010b00002CphGRAAZ, DIRECT, bbea06d9c4d2853c adtech.com, 9993, RESELLER aolcloud.net, 9993, RESELLER appnexus.com, 1001, RESELLER appnexus.com, 10239, RESELLER, f5ab79cb980f11d1 appnexus.com, 1356, RESELLER, f5ab79cb980f11d1 appnexus.com, 3135, RESELLER criteo.com, 3450, RESELLER emxdgt.com, 326, RESELLER, 1e1d41537f7cad7f google.com, pub-9557089510405422, RESELLER, f08c47fec0942fa0 gumgum.com, 13318, RESELLER, ffdef49475d318a9 indexexchange.com, 185506, RESELLER openx.com, 537120563, RESELLER, 6a698e2ec38604c6 openx.com, 539392223, RESELLER, 6a698e2ec38604c6 pubmatic.com, 156423, RESELLER, 5d62403b186f2ace rhythmone.com, 2439829435, RESELLER, a670c89d4a324e47 rubiconproject.com, 16414, RESELLER, 0bfd66d529a55807 33across.com, 0010b00002CphGRAAZ, DIRECT, bbea06d9c4d2853c rubiconproject.com, 16414, RESELLER, 0bfd66d529a55807 rubiconproject.com, 21434, RESELLER, 0bfd66d529a55807 pubmatic.com, 156423, RESELLER, 5d62403b186f2ace pubmatic.com, 158136, RESELLER, 5d62403b186f2ace pubmatic.com, 158569, RESELLER, 5d62403b186f2ace appnexus.com, 10239, RESELLER, f5ab79cb980f11d1 appnexus.com, 1001, RESELLER, f5ab79cb980f11d1 appnexus.com, 3135, RESELLER, f5ab79cb980f11d1 openx.com, 537120563, RESELLER, 6a698e2ec38604c6 openx.com, 539392223, RESELLER, 6a698e2ec38604c6 rhythmone.com, 2439829435, RESELLER, a670c89d4a324e47 emxdgt.com, 326, RESELLER, 1e1d41537f7cad7f adtech.com, 12094, RESELLER adtech.com, 9993, RESELLER advangelists.com, 8d3bba7425e7c98c50f52ca1b52d3735, RESELLER, 60d26397ec060f98 google.com, pub-9557089510405422, RESELLER, f08c47fec0942fa0 #WordPress - AdMixer admixer.net, 773de910-6013-40f3-b290-f31c7cd89795, DIRECT #WordPress - Sonobi sonobi.com, 31f001801f, DIRECT, d1a215d9eb5aee9e rhythmone.com, 1059622079, RESELLER, a670c89d4a324e47 contextweb.com, 560606, RESELLER, 89ff185a4c4e857c sonobi.com, 31f001801f, RESELLER, d1a215d9eb5aee9e #WordPress - OpenX openx.com, 540649015, DIRECT, 6a698e2ec38604c6 #WordPress – District M districtm.io, 101710, DIRECT, 3fd707be9c4527c3 appnexus.com, 1908, RESELLER, f5ab79cb980f11d1 google.com, pub-9685734445476814, RESELLER, f08c47fec0942fa0 #WordPress - LKQD lkqd.net, 572, DIRECT, 59c49fa9598a0117 #WordPress - Triplelift triplelift.com, 8580, DIRECT, 6c33edb13117fd86

The Dartboard of Customer Loyalty


As technical writers, we prepare documents that contain technically accurate information. But, is that enough? Do we deliver documents that are technically accurate, but practically useless? The truth is: we often do.

In most cases, we deliver documents with the purpose to only support our products. The idea that documents serve as “troubleshooters” is incorrect. Seems we must plan our documents as the one-stop point-of-reference for our products.

In my previous post, I’ve discussed about refining the definition of quality in documentation. Technically, this post begins where I concluded that conversation.


Customer loyalty is dependent on how well we address our customers’ requirements. It is the need/want of our customers that drives their purchase decisions. Therefore, it is their needs/wants that should be the basis of our documents. Sadly, in most cases it is the product features, and not business implications of those features that drive our documentation.


We’ve talked about this before. We’ve noted that it is not the features, but the benefits that sell. I’ve even quoted it in my previous post. I see that there is a connection between “findability” and loyalty. Now, if it is brand loyalty (or product loyalty) is a question that I would like to address in one of my next posts.

I am acting team lead for my current project. And, although it is not the first time I am in the leader’s chair, the project has had a lot of learning for me. Also, based on my analysis, I have prepared a methodology, which I will share with you in this post. The methodology, which I’ve called the dartboard approach, has helped my team in overcoming a couple of big-sized challenges.

The first challenge was to update our documentation based on the new features and enhancements of previously released features in over 2000 pages. Now, for a team of three people (other writers are on the other products), it was difficult to incorporate changes (given the page count) in just 25 days. And, that includes Sundays!

The second challenge was to document the everyday changes as our “work-baby”–as we’ve termed it–learned to turn her head; begin to sit, crawl, and toddle; and eventually graduate in three streams. This meant loads of non-calculated, unplanned, and miscellaneous (but strategic) work, which was impossible to track back, nominate, or delegate. Phew! But, as I said, I learned a lot, and was just in time to attend the “graduation ceremony” of our work baby. We will discuss more about the challenges in Examples, in this post.

As I said, this post logically takes it up from where I concluded previously. Turns out, my new definition–to refine the quality parameters on the time taken by my users to find what they were looking for–worked! While the new definition did not relieve any stress with respect to the mechanical proofreading, it did help me a great deal in planning (and delivering) my documentation effectively during both the challenges.

The Solution–The Dartboard Approach

The following is the dartboard approach for your reference. Note that irrespective of what documents you plan, customer loyalty and user findability will always represent the two innermost concentric circles:

The Dartboard Approach
The Dartboard Approach

I’ll go back to where we started. At times, the gap between what we promise (to fulfill our customers’ requirements) and what we deliver (product and its features) is huge. Therefore, as tech writers, we should try to prepare our documentation based on what our customers require, and not on what our products are made to do.


I will pick an example from my current project. We have introduced a time-phased formula in our software for process manufacturers. The formula is useful in case of seasonal variations in formula. But, rather than explaining the formula and its features, we’ve provided details of the changes our customers observe when they implement this feature.

We followed a similar approach when we prepared the release notes for the GA release of our product. For the Known Issues section of our release notes document, we’ve prepared write-ups for the issues based on what our customers will encounter, and not based on the bottlenecks in our coding. That’s because our customers may not understand the code, but they will understand the business impact of the missing links. I remember reading a draft similar to the following:

“On account of differences in the code logic for recording the decimal values in the UOM_MTR_TAB1 table, the records are processed incorrectly, and a message similar to the following is reported: ‘Total lot quantity should be equal to required quantity <quan_mtr> for item <itm_db>.’”

Although the writer recorded exactly what was happening, but she missed the point. So to say, she lost the reader. Quite obviously, even if the SMEs agreed that the release note was “technically” correct, we could barely give any response beyond “Eh!”

Later, we finalized the following version, which I believe briefed our customer on what the issue was:

“On account of differences in the rounding-off for decimal values in the primary table for the Units of Measure (UOM) module, the system does not issue the items when the display UOM and system UOM are different, and a message similar to the following is reported: ‘Total lot quantity should be equal to required quantity <quan_mtr> for item <itm_db>.’”

Any write-up, or document, which explains the need for documentation, scores better on the dartboard approach as well as in the eyes of our readers.

Now, I will like to mention something. When I make a purchase decision, I have my reservations against product brochures. So to say, I rely more on reviews than on the marketing collaterals. When writing professionally, we tend to stress on what we have for our readers/customers, and not on what they might look for in our products. Considering the dartboard approach, we are missing the “point”. It makes sense to write based on the business benefits in features, and not mere describe the features.

I recall another example where the dartboard approach rescued us. We recently updated the write-up for the Create Planning Calendar form into our product. The feature provides a capability to assign work and non-work days in a calendar. The values are set as part of the implementation process, and by the time you bring your data live, you have your production vessels marked based on the production schedule you created using the feature. I am sure had I not thought of it through the dartboard approach, I wouldn’t have appealed my readers.

But, do I need to “appeal” them? Yes, I need to! But I also need to be grammatically correct, technically accurate, and make the information findable.


As I approach the end of this post, I recall having learned one easy-to-learn-but-difficult-to-follow lesson during my first stint as a sales rep-cum-writer: One customer is nine customers put together. I see how valid it is even in technical writing. If I can make my readers understand and follow what I write, I’ve done a satisfactory job.

I see my profile as that of a silent ambassador. My documents talk a lot about me, my products, and my value proposition (my promise). And, as I see it, my readers’ loyalty towards my products is only as good as my loyalty towards my profession.

Let me know your comments on the dartboard approach. I also am eager to know how it brings value to your content.

%d bloggers like this:
google.com, pub-2035719743358482, DIRECT, f08c47fec0942fa0