Back to articles

Writing Without Hiding

May 22, 2026

TechWritingSystems

I wrote the wrong article this week and used that mistake to define a stricter rule for what belongs on ozzo.blog versus product channels.

Writing Without Hiding

I wrote the wrong article this week.

I turned a builder decision into a feature narrative. This post is the correction: a clear record of the decision, the cost, and the operating rule I’m applying from now on.

The Real Problem

The visible problem was onboarding friction in product work.

The real problem was editorial drift.

When execution pressure goes up, I default to safe writing:

  • what shipped,
  • what improved,
  • what comes next.

That structure is useful for release notes. It is weak for a personal blog because it hides the decision logic under activity.

If ozzo.blog becomes a place where I only summarize output, I lose the only thing that compounds in public: legible judgment.

The Decision

I made one explicit choice.

I will treat ozzo.blog as a decision log for a solo builder, not as a mirror of product updates.

That also means rejecting the old fallback: publishing technically correct posts that avoid the uncomfortable part of the week.

The test is simple.

If a draft explains what changed but not why the trade-off was worth it, it is not ready.

What Changed in Practice

I applied three concrete changes immediately.

First, I separated channels as a hard boundary:

  • synergym.fit/blog for releases and feature communication.
  • ozzo.blog for decisions, constraints, mistakes, and operating model.

Second, I created an explicit editorial contract in the vault:

  • content/editorial-rules.md

That file defines the linear article shape and pre-publish quality gate for Hermes and for me.

Third, I added a strict draft gate with four mandatory answers:

  1. What tension defined this week?
  2. What did I choose and what did I give up?
  3. What concrete change did I apply?
  4. What behavior changes next week?

If one answer is weak, the draft gets another pass.

Evidence still matters, but only as support. Artifact references from this cycle (for example commits 4aa7513, 954b214, 75204d2) are grounding material, not the story itself.

The Trade-off I Accept

I’m accepting lower frequency for higher signal.

This choice has a cost:

  • fewer easy publishes,
  • more editing time,
  • slower weekly closure.

I accept that cost because speed without clarity creates a false sense of progress.

A short stream of polished but generic posts is worse than one article that states a real tension and a real decision.

The Operating Rule for Next Week

One weekly article. One central tension. One decision with an explicit cost.

Before publishing, the draft must contain:

  • one concrete implementation change,
  • one rejected alternative,
  • one behavior change for the next seven days.

No feature-recap structure unless the destination is the product blog.

Why This Matters

This is not a style tweak.

It is an execution control mechanism.

As a solo builder, writing is one of the few places where weak thinking becomes visible early. If the writing is vague, decisions are probably vague. If decisions are vague, the roadmap drifts.

A linear writing standard protects direction.

That is the point of this week’s correction.

Not to look polished.

To stay legible, week after week.

© 2026 Giorgio Ozzola. All Rights Reserved.

RSS Feed

Inspired by Takuya Matsuyama

Version: 1.5.0