top of page
Blog


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


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


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


Gestructureerd schrijven in een notendop
Structured writing in a nutshell
bottom of page

