Author: Marcel

  • Practice Note: The Paragraph Is the Unit of Thought

    Writing is often reviewed one sentence at a time. Is the grammar correct? Is the wording clear? Is the sentence too long? Could a stronger verb be used?

    These are useful questions, but they may focus attention on the wrong unit. A sentence can be perfectly written while the paragraph around it remains confused. Several individually strong sentences do not necessarily form a coherent argument.

    I increasingly suspect that the paragraph, rather than the sentence, is the fundamental unit of expository writing. A sentence carries a statement. A paragraph carries a thought.

    I first learned to recognize this structure through summarization. To summarize a text, I was taught to examine each paragraph and identify its main statement. That statement was often found at the beginning or the end. The remaining sentences provided explanation, examples, qualifications or supporting detail. Remove that elaboration, and the central message of the paragraph remains.

    Writing can be understood as the reverse operation. Begin with a governing statement. Then develop it through explanation, evidence, examples or consequences. Sometimes the paragraph opens with the key idea and explores it. Sometimes it begins with an observation or example and only reveals its conclusion at the end. In either case, the sentences belong together because they perform different roles within the same thought.

    This became especially visible while editing text produced through conversations with AI. AI can generate convincing sentences very quickly. It also tends to give important statements dramatic isolation, placing each one in a separate paragraph. Used occasionally, that can create emphasis. Used repeatedly, it produces a staccato rhythm in which every sentence appears to demand attention. The result may resemble a speech or a social-media post more than a reflective essay.

    I found myself gathering those isolated sentences into more substantial paragraphs. I identified the key statement and placed the relevant explanations and examples around it. Short sentences could still provide emphasis, but they now concluded or punctuated a developed thought rather than standing alone by default.

    At first, I considered this an editorial preference. It gradually became clear that I was doing something more important. Regrouping the sentences forced me to understand them.

    I could not merely read through a proposed draft and accept that it sounded plausible. I had to decide which idea governed each paragraph, which sentences supported it and where the thought reached its natural conclusion. If two sentences could not comfortably share a paragraph, I had to ask whether they really belonged to the same argument. Paragraphing became a reviewing technique.

    This suggests a simple way to test a piece of writing: summarize every paragraph in one sentence. If the governing thought is difficult to identify, the paragraph may contain several competing ideas—or none that has been developed clearly enough. If several consecutive paragraphs produce essentially the same summary, the text may be repeating itself.

    The reverse test is equally useful. Once the governing statement has been identified, ask whether the rest of the paragraph genuinely helps the reader understand it. Elaboration should develop the thought, not merely lengthen the text.

    This applies beyond AI-assisted writing. A report, essay or paper may contain accurate statements yet remain difficult to follow because the reader cannot see how they form coherent units of reasoning. Good paragraph structure gives the argument shape. Each paragraph makes one contribution and prepares the transition to the next.

    Perhaps this is why paragraphing should not be treated as formatting. It is part of thinking.

    A sentence carries a statement. A paragraph carries a thought.

    The sentence may be the smallest unit we write. But the paragraph may be the smallest unit through which we genuinely explain.

  • Practice Note: System Continuity

    Systems fail when continuity is broken. When we think about continuity, we usually think in technical terms: backups, version control, redundancy or disaster recovery. Those preserve systems.

    But there is another kind of continuity that is just as important:

    The continuity of understanding.

    A few years ago, after my father passed away, I inherited many of his belongings. Some objects immediately meant something to me. His field glasses, for example, reminded me of my childhood. They carried a story, and because of that story they retained their meaning.

    Many other objects did not. They may have been just as important to him, but I simply didn’t know why. Without their stories, they became little more than anonymous possessions. The objects survived. Their context did not.

    Software systems suffer from exactly the same problem. Production systems often survive for decades. The source code is still there. The database still exists. Diagrams, tickets and documentation may still be available. Yet the people who understood why the system was designed that way have long since moved on.

    A peculiar integration remains, but nobody remembers which dependency required it. A workaround survives, but the incident that justified it has been forgotten. A business rule is still enforced, but nobody knows why it was introduced. The system survives. Its context does not.

    The next generation inherits the equivalent of a room full of possessions: many artifacts, some clearly important, others seemingly meaningless, with very little explanation of the stories that connect them.

    Without those stories, maintenance becomes archaeology. Changes become risky because nobody can distinguish deliberate design from historical accident.

    That experience has changed the way I think about documentation. Documentation does not preserve knowledge. At best, it preserves information. Knowledge survives only when enough context is preserved for future people to reconstruct the original meaning.

    Knowledge is not preserved by storing documents. Knowledge is preserved by maintaining enough context that future people can reconstruct the original meaning.

    That context rarely consists of technical details alone. Sometimes it is the problem that triggered an idea. Sometimes it is the trade-off that was consciously accepted. Sometimes it is a story. Sometimes it is simply the answer to a single question:

    Why?

    Perhaps that is the real purpose of documentation. Not to describe every detail. But to preserve enough understanding that the next person can continue the story instead of starting over.

  • Practice Note: The Boundary Defines the Object

    We often think that an object’s identity is determined solely by the object itself. It isn’t. The boundary around an object profoundly influences how we perceive the object within it.

    A photograph does not change when you replace its frame. Yet a black frame can make the colors appear richer, while a wide white mat can make the same photograph feel more spacious or more like a piece of art. A television does not become larger when Philips Ambilight projects light onto the wall. Yet the image appears to extend beyond the physical screen because the boundary of the display has changed.

    The same principle appears in industrial design. While experimenting with different straps on a Victorinox I.N.O.X. wristwatch, I noticed something unexpected. The watch itself—the steel case, dial and movement—remained exactly the same. Only the strap changed.

    On the steel bracelet, the watch is perceived as one continuous piece of engineering—a substantial object made of steel. The steel bracelet and the case compete for attention, together forming a single architectural object. Replacing the bracelet with a black leather strap completely changes the visual hierarchy. The leather quietly recedes into the background, allowing the eye to focus almost entirely on the distinctive hexagonal steel case. The watch has not changed. Yet it feels like a different object. The boundary determines what our attention considers to be the object.

    Music demonstrates the same principle in time rather than space. A skilled musician knows that silence is not the absence of music—it is part of the composition. Bass players, for example, will sometimes stop playing briefly to create tension. The temporary void changes how the audience experiences what follows. When the bass returns, listeners instinctively experience a sense of release. The notes have not become better. The silence has changed how they are perceived. In music, silence is the boundary that defines the notes.

    Good design often understands this instinctively. It is not only the product that is designed; it is also the context in which the product is experienced. Architecture uses pedestals, lighting and empty space to make sculptures more powerful. Graphic design uses margins and whitespace to make information easier to understand.

    Perhaps this is a more general design principle:

    The boundary does not merely surround the object. It defines the object.

    When trying to improve something, we often redesign the object itself. Sometimes the better question is:

    Can I change the boundary instead?

    If this principle applies equally to photography, architecture, music, industrial design and product design…

    …what might it mean for software?

  • Blog Retrospective #2

    I completed the next twenty posts, bringing the total to forty. Since I agreed with myself to pause for a retrospective after every twenty posts, here is the second one. It feels as though I have completed an initial theoretical loop around product quality assessment.

    During this cycle, the investigation moved through several connected questions:

    • What distinguishes assessment from testing, QA and quality engineering?
    • What must exist before meaningful assessment is possible?
    • What belongs in a product reference model?
    • Who owns and maintains that model?
    • How should evidence support judgement?
    • How does assessment continue after deployment?

    The final field notes brought many of these questions together in Product Quality Assessment as a Continuous Discipline.

    What Surprised Me?

    The biggest surprise was the growing importance of the product reference model. It began as the reference against which a product could be assessed. It gradually became something closer to a shared description of what the product is intended to achieve, what good looks like, which constraints matter and what evidence is needed.

    A second surprise was the emergence of Product Ownership as the continuity mechanism connecting business intent, engineering interpretation, release judgement and operational learning.

    A third surprise was that the field notes began reinforcing one another. Ideas that appeared speculative in isolation became more credible when placed into a coherent chain.

    What Became Clearer?

    Several propositions now seem reasonably stable:

    • Quality is the integrity of the chain from business intent to realised outcome.
    • Testing can be understood as a form of assessment, but product quality assessment is broader than testing.
    • Meaningful assessment requires an explicit reference model.
    • The reference model must guide implementation as well as evaluation.
    • Assessability and evidence need to be designed in.
    • Product quality cannot be fully understood at release. Operational evidence must complete the judgement.

    These are still working propositions, but they increasingly appear to form a coherent whole.

    What Remains Unproven?

    The theory has not yet been validated as an operational model. Important questions remain:

    • Can a useful product reference model be maintained without becoming bureaucratic?
    • What is its minimum viable form?
    • Can product quality assessment become part of normal delivery rather than a separate governance process?
    • Does it lead to better findings, decisions and priorities in practice?

    The business-intent side also needs more development. Much of the thinking so far has focused on engineering, testing, evidence and reference models.

    What Comes Next?

    The next step is probably not another rapid expansion of the theory. I want to begin consolidating the existing thinking around one master theme:

    Quality from Business Intent to Outcome

    Supporting themes may include:

    1. Testing as Assessment
    2. The Product Reference Model
    3. Product Ownership and Quality Judgement
    4. Continuous Product Quality Assessment

    These should be treated as evolving synthesis pages rather than finished statements.

    For the field notes, I first want to propose a conceptual table of contents for the product reference model. After that, I expect to return to assessment itself: the assessment model, the relationship between evidence and judgement, and perhaps a few conceptual capability models.

    I also want to revisit a historical assessment and see whether the emerging approach produces better or simply different findings.

    Conclusion

    The first retrospective asked what was happening to the writing process. This retrospective asks what has happened to the subject itself.

    Product quality assessment began as an attempt to describe testing differently. It expanded into questions about reference models, Product Ownership, evidence, operational learning and governance.

    The result is not yet a proven method. But it is becoming a coherent discipline. The next step is to find out whether it can also become concrete, usable and valuable in practice.

  • Practice Note: Product Quality Assessment as a Continuous Discipline

    Product quality is often assessed at particular moments:

    • A requirement is reviewed.
    • A feature is tested.
    • A release decision is made.
    • An incident is investigated.
    • Customer feedback is analyzed.

    Each activity may produce useful evidence. But when they remain disconnected, no one continuously maintains the overall basis for judging the product. If quality is the integrity of the chain from business intent to business outcome, product quality assessment cannot be reduced to a single test phase or release gate. It must become a continuous discipline.

    Assessment Begins With Intent

    Before a product can be assessed, there must be a basis for judgment. What is the product intended to achieve? For whom? Under which conditions? Which qualities matter? Which constraints must be respected? What evidence would indicate success or failure? Together, these expectations form the product reference model.

    Requirements and acceptance criteria may be part of that model, but they are not the whole of it. The model may also include intended outcomes, stakeholder needs, quality characteristics, risks, assumptions, operating conditions and evidence requirements.

    Without such a model, testing may still find defects. But it becomes much harder to judge whether the product as a whole is fit for its intended purpose.

    The Model Must Feed Development

    The reference model should not be created only so that someone can assess the finished product. It must also guide the people building it. Quality expectations have design implications. Performance expectations influence architecture. Auditability requires traceability. Resilience requires detection and recovery mechanisms. Business outcomes require ways to observe whether those outcomes occurred.

    The question is therefore not only whether an expectation can be tested later. It is whether the product is being designed to satisfy the expectation and produce the evidence needed to assess it. Assessment begins before implementation because the basis for later judgment influences what must be built.

    Evidence Accumulates Across the Lifecycle

    Testing provides essential evidence, but it provides only part of the picture. Reviews, analysis, demonstrations, security checks and performance tests may contribute evidence before release. Monitoring, incidents, support cases, user behavior and business results contribute evidence after release. Some qualities can be assessed with confidence before deployment. Others can only be fully understood in operation.

    Continuous product quality assessment brings these sources together rather than treating them as separate activities belonging to different functions. The purpose is not to gather as much evidence as possible. It is to gather the evidence needed to make responsible judgments about the product.

    Judgment Must Be Explicit

    Evidence does not make decisions by itself. Someone must interpret what the evidence means in relation to the reference model, the remaining uncertainty and the risks involved. Is the product ready to release? Are known limitations acceptable? Did the product create the intended outcome? Has new operational evidence changed what the organization believes about it?

    Product Ownership safeguards the coherence of the product reference model. Specialists contribute evidence and professional judgment. Leadership sets strategic direction, constraints and acceptable risk. Assessment integrates these perspectives into a product-quality judgment.

    The Cycle Does Not End at Release

    A release is not the conclusion of product quality assessment. It is the point at which new forms of evidence become available.

    Real use may reveal that assumptions were wrong. Customers may value different outcomes than expected. Operational conditions may expose risks that pre-release testing could not reproduce. A product may function correctly and still fail to produce the intended business result.

    This evidence should not only lead to fixes. It should update the product reference model itself. The continuous cycle becomes:

    intent → reference model → development → evidence → judgment → operation → learning → revised intent

    The product changes. Its context changes. What the organization knows about it changes. The basis for judging it must change as well.

    A Discipline, Not an Additional Phase

    Product quality assessment is not a new phase wrapped around testing. It is the continuous discipline of maintaining the basis for product-quality judgment from intent to outcome. Testing remains essential. QA and quality engineering remain valuable. Product Ownership, operations and leadership all retain their distinct responsibilities. But their contributions become more useful when they support one coherent and continuously updated judgment of the product.

    Quality is not established once. It is assessed, learned from and reassessed throughout the life of the product.