Diagram Series: Troubleshooting

If you read my previous articles from the Diagram Series, you are already familiar with the process of creating diagrams, the role of text in diagrams, practical tips, and so on. Now let’s see how to troubleshoot issues that accompany you from the first drawing and to the final approved diagram.

The most informed people to create diagrams are SMEs, yet they are the least appropriate for this role.

Continue reading

Advertisements

Diagram Series: Common Mistakes

When creating diagrams, you may overlook some tiny, but crucial drawing details. And only after the review, you understand how important these details are. In this article, I will explain some of the most common mistakes when creating diagrams and how to escape them.

Continue reading

Diagram Series: The role of text

A well-drawn diagram communicates a very clear and direct message. You, as an Information Developer, can explain to users the workflow, interrelationship among components, or data exchange through visual assets. Diagrams are not just about cool shapes and trendy colors, but also about the meaning—text. In this article, I will share some important rules how to phrase, format, and position the text in a diagram to make it look more distinct and professional.

Continue reading

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

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