Writing software documentation is like building furniture
Why software documentation needs more than words In software documentation, images aren’t optional: they are essential. Screenshots help users confirm that they are in the right place. Icons guide them through actions without language barriers. Diagrams clarify workflows. And mock-ups? They future proof your content when interfaces change faster than you can update a support page. But visuals must be purposeful: too many screenshots clutter, outdated ones mislead, and poorly

Wouter Verkerken
1 dag geleden
Graphics tip: Process flows shape understanding
(while Flow shapes understanding!) A process flow brings the underlying architecture to life, doesn't replace it (and vice versa). In technical documentation, flows that use the Business Process Model and Notation (BPMN) standard serve a vital role: they clarify processes in a consistent way. What is BPMN? BPMN is a standard for the graphical representation of business processes. By using this notation, you represent complex processes as diagrams that will be clear to underst

Wouter Verkerken
17 feb
No more mystery tins: labels add meaning to content
The importance of semantic markup for chatbots and AI agents You may have heard about this wedding-day prank that is sometimes played on a befriended couple: remove all labels from the canned goods in the pantry and neatly return the "blind" cans to the shelves. The result is confusing at best, with time and again a surprising answer to the question "what are we having for dinner tonight?". Welcome to the world of unstructured content . Life's a box of chocolates (or unlab

Yves Barbion
12 jan
















