Your documentation is a model, not a wiki page
Why structured architecture docs are the most undervalued asset in engineering, and how AI is about to change that
David’s Substack
My personal Substack. I'm bootstrapping open source software, learning a ton along the way, through the challenges and sharing this with you all.
Live Last read · last published · next check
Latest episodes
Your AsyncAPI specs deserve more than a repo. Give them discoverability.
Most teams write specs and forget them. Here's how to turn them into a catalog your whole org can browse, search, and understand.
Domain-Driven Documentation: Documentation was never the problem
Why context, not content, is the real challenge for modern documentation
I think I just hired...... a robot?
I Installed OpenClaw 48 Hours Ago… and It’s starting to feel like a teammate
Don't sell to developers. Focus on value, advocacy and creating internal champions
My thoughts and lessons on selling to developers; and why a focus on value, advocacy and internal champions can help.
Can you get more value from your EventStorming workshops? I think you can....
So you finished an EventStorming session, you have 100s of post-it notes. What's next? In this blog post I explore an experiment of turning EventStorming into EventCatalog using MCP.
Before You Publish Your First Event… Stop.
The hidden trap in event-driven architecture that few talk about
Do we need another diagram tool? Maybe not… But I think we can do better
My thoughts on the pitfalls of diagram tools today, the value lost, and why we can do better.
How to Stop Your Event-Driven Architecture from Turning Into Chaos
The three most common pitfalls organizations fall into when building event-driven architectures.
Event-driven architecture is a shit show - It’s time to fix it
Reflecting on event-driven architecture, it's problems and what needs to change.
From side project to full time; 12 months of open source
Some lessons learnt turning my open source side project into a full time job.
10 Lessons from 6 Months of Bootstrapping My Open Source Startup
Here are 10 lessons I have learnt so far whilst bootstrapping my open source project into a sustainable product.
Can a product release too often? Yes, I think it can.
As a bootstrapped developer it's easy to keep caught up just shipping features, especially as we lean into AI tools to assist us, but going too fast might be a problem?
Why is your product Open Source?
Open source business models are hard. A question I often get it why is it even open source? Here are some of my thoughts on that, and reasons why
Coming soon
This is David’s Substack.