Linear User Guide: Is It any Good?

Many believe that written user guides are doomed to extinction. Although their usage has diminished slightly, they are not clean gone yet. They are still with us—serving their particular audience and making us wonder what is the best approach to structuring them.

With the rise in the popularity of online documentation, many have ditched linearity and adopted a topic-based approach to writing—faster, more convenient, and definitely more efficient from the user perspective; absolutely challenging from the author perspective. But is such an approach still any good for structuring user guides which, unlike help systems, don’t provide immediate assistance to the user, differ in the very context of use, and are designed with a clear intention—to teach and guide?

Continue reading

Advertisements

Prototyping: InVision Experience

As an Asian saying goes, it is better to see something once than to hear about it a thousand times.  When somebody describes you some concept you can try to imagine each tiny detail, every piece of the whole, each brick in the wall, but there is always a thing that somehow slips your mind.

Continue reading

Video

Microsoft Manual of Style vs. Microsoft Writing Style Guide

Since its first publication in 1995, the Microsoft Manual of Style has been a Holy Grail of editorial wisdom for rookie and experienced tech writers alike.  In January, Microsoft released a new edition—the Microsoft Writing Style Guide. How different are the 2012 version we’ve been relying on for the past few years and the 2018 one? Let’s take a quick glance.

Continue reading

Book review: Logic made easy. How to know when language deceives you?

Logical thinking is high on the list of qualities expected from any Information Developer. But what exactly is “being logical”? If my writing is seemingly clear and makes sense to anyone who reviewed it, am I thinking logically? My layman’s definition of “logical” used to be “making sense”, but recently the book Logic made easy has come my way and added a lot to my understanding. Continue reading