A library can change the people around it because it feeds their minds; that’s the mark of knowledge management Based on Wikipedia: Knowledge management (KM) is the collection of methods relating to creating, sharing, using, and managing the knowledge and information of an organization. Behind a set of methods, there…

Users have problems to solve, software engineers have solutions to build, and technical writers connect them like a bridge: the ubiquitous language recipe is the concrete of that bridge — Domain-driven design is not yet a standard At least in the software industry, why is the domain-driven design approach not a consolidated standard? I asked ChatGPT, which answered: There could be several reasons why domain-driven design (DDD) approach is not yet a consolidated standard in the software industry:

I am a technical communicator who wants to bring his work to the next level of impact on human life; is that ambitious? It is. — An unstructured flow of thinking: that’s this article. Just to let you know. Some time ago, I wrote I Love the Technical Writing Niche, Yet, Let’s Go Beyond. It’s time to follow up on this intention. There’s a foundational approach that makes technical communication possible: asking questions. …

AI and photography share the essence of automating knowledge acquisition — Comparing AI and photography helps us understand what’s happening with ChatGPT and all similar technologies. Sure: they are profoundly different due to the significant contrast I’ll describe. Yet, they share the same intention: automating how to represent the world. Photography Before photography, painters were in charge of visually representing the world.

Does it sound trivial? It’s not. The problem-solution short-circuit is the most frequent mistake people under pressure make, and we’re all under pressure — Following up on the overview I wrote in Domain-Driven Design Is the Breakthrough Language for Technical Writing, today I want to focus on the core of designing a solution: separating the solution from the problem. Sounds trivial? It’s not. To explore why, let’s rely on Learning Domain-Driven Design: Aligning Software…

In the software industry, technical writing is sometimes a Cinderella, but that’s underestimating the opportunity to improve the business through writing — Suppose you are not a technical writer and are in charge of deciding the budget for technical writing. Which criteria should lead you to choose? Value First, what’s the value of technical writing for your project? I see two possible answers: Technical writing is an obligation because the project deliverable requires…

Learning is a fundamental facet of our job as knowledge workers: let’s tame it! — Quoting Wikipedia: Human learning starts at birth […] and continues until death as a consequence of ongoing interactions between people and their environment. For each human being, learning and breathing come and go together. That’s a truth that many people often allow themselves to forget. It’s a pity. Yet, there’s…

If ChatGPT — or something similar — gives perfect answers, what about asking questions? — Feeling hype is human and feeling fear, too. That’s why humans are less efficient than machines. Hype and fear obfuscate the perception of happenings and the ability to stay rational. The hype around the successes of AI in providing answers with natural language is made up of wonder. Ultimately, ChatGPT…

When interviewing subject matter experts (SMEs), technical writers need a fast, disciplined, and organized way to jot down what they get — SMEs speak fast, and what they say is difficult. On the other hand, taking notes is crucial to get enough information to build valuable documentation. So, year after year, I’ve collected some tips to make the process more and more effective. That’s my recipe! #1: Personal conventions