Diagram Series: Pitfalls of interviews with SMEs

Look at the following broken-line graph (Figure #1). How much time do you need to create one? 5 – 10 minutes? How about two days?

Figure #1 (Click to enlarge)

Now, if I provide an estimate of two days for creating a graph, my Customer will expect to receive a 3D visualization, in color. Then, where is the problem? Why creating a graph with a few broken lines might take that much time?

Continue reading

Advertisements

Diagram Series: Decrypting SME’s Drawings

User documentation that includes different types of graphics is more effective and easier to perceive than monotonous text. A diagram is just one type of graphics that prevails mostly in technical documentation. When creating diagrams on a daily basis, you eventually learn to overcome such difficulties as: vague explanations, inaccurate SMEs’ drawings, abundance of details, or lack of information. As an Information Developer, you must know how to combine these diverse chunks to create consistent graphics in user documentation. In this article, I will discuss some tips on decrypting SME’s drawings to make the process of creating diagrams an interesting and creative experience.

Continue reading

All you need to know about user personas (Part II)

In the previous post, we discussed who user personas are and why they are important for Information Developers, considered key elements that should be included into a persona card, and reviewed a user persona sample card.

In this article, I will provide steps on how to create user personas, share some practical tips, discuss how Information Developer can apply user personas, as well as give references for further reading.

“Personas are a way to give the user a seat at the table every time.” Kendra Shimmell

Continue reading

All you need to know about user personas

For decades, the concept of user personas has been associated with marketing, advertising, user-centered design, and business analysis. Nowadays, personas are winning the deserved attention of Information Developers worldwide.

Usually, the creation of user personas is initiated by UI/UX designers or business analysts. But what if you do not have any in your team? In my project, I created user personas myself and was surprised how it changed the quality of my content.

Deep understanding of readers is fundamental to creating qualitative and effective content.

In this article, I am going to review and consider user personas from the perspective of an Information Developer.

Continue reading

Navigation Links: Types and Usage

In the previous article “Navigation Links: Introduction”, we discussed typical mistakes that Information Developers make when creating navigation links and established some guidelines on how to use navigation links correctly to make the content more concise, accurate, and scannable for users.

In this article, we are going to discuss the most common types of navigation links, their usage, as well as tips and tricks on how to use them correctly.

Continue reading