For the last few years, I have been working on the hardest/longest project of my career.
http://docs.marketo.com – The Marketo User Manual
A few years back, I did a series of interviews of our customers. Specifically, I spoke to customers who thought the product was “too hard”. Turns out that part of the problem was the the documentation was suffering from the worst UX sins possible. These included:
- Factually incorrect/outdated content
- Poor tone (boring, cold, unfriendly)
- Verbose (like 10X longer than it needed to be)
- Complicated vocabulary
- Confusing, conflating multiple ideas
- Outdated and confusing pictures
- Poor organization
As a result of those interviews and our findings, the UX team (led by me) took ownership of the documentation process. It has been several years, but it finally is launched in public form. I tried to fix all of the sins mentioned and am quite proud of the results.
One thing I believe is that the UX team is actually a great group to give ownership of documentation. There are two primary reasons:
- No one knows the details as well as the designer of the feature
- Designers will make it fun and easy to read
However, there is a problem. Designers are mostly (not all) prima donnas who think that writing docs is beneath them. I had a terrible time getting designers to pitch in. Additionally, their skills at summarizing a design into a teachable article was shockingly poor. A great designer should be able to teach people how to use the product they design, wouldn’t you think?
Alas, it was not to be. I found a couple of people who were willing to do the real work with me. (Shout out to Reza Farpour and Anna Zeman! – both were instrumental in getting this thing done.) They did a tremendous job, although after a while, it did wear even on them.
I consider the docs work to be true User Experience Design. When a customer is confused and doesn’t know how to achieve a goal, they either go to the community forums or look up the documentation. That is the moment you can come to the rescue with a simple walk-through and make them happy.
Good documentation contributes to good UX. It’s a chance to have personality and create an emotional connection. It usually hits people when they are at their most vulnerable. A great UX at that moment will create a super fan.
Technical detail: We used the Atlassian Confluence wiki as the CMS. It has this wonderful feature where you can paste (from the clipboard) any image. It automatically uploads it to the server. Not even my beloved WordPress can do that. This brilliant feature alone more than quadrupled our productivity.
I have recently handed the reigns of the site to another person. We think he will be a good custodian of the awesome nature of the site. I hope he will take good care of my baby. It has been the longest and most rewarding effort of my career.
When you get a chance, click HELP inside any application. Think about the UX.