Your Documentation Is Your Funnel (And the One Page Nobody Writes)
Most companies file documentation under engineering and marketing under marketing, then wonder why the funnel leaks. For a developer product, the docs…
Architecture
⚑ Report a ProblemLatest Architecture news from Tech News
All topics
agents
ai
api
architecture
automation
aws
backend
beginners
career
database
devchallenge
devops
discuss
javascript
llm
machinelearning
mcp
opensource
performance
productivity
programming
python
react
security
showdev
softwareengineering
systemdesign
tutorial
typescript
webdev
Good Documentation Explains the Decision, Not Just the Code
A pattern I’ve seen many times in software projects is that documentation starts too late and documents the wrong thing. A team ships a feature, the c…
Database Context Views Should Show the Relationships They Hide
Disclosure: I build Schemity , a desktop ERD tool - this post is from our blog and uses it for the examples. TL;DR: Focused sub-diagrams remove noise,…
My Project Docs Aren't For Humans Anymore. They're For an Agent That Re-Reads Them Every Session.
I used to write docs/ the way I was taught: prose paragraphs, a little context, a "why we did this" narrative you'd hand to a new hire. Then I noticed…
A low-tech repo context pattern for AI coding agents
I have been trying to keep repository context useful for AI coding agents without turning it into a large prompt file or depending on a specific vendo…
I Reviewed 10 AI Startup Documentation Sites. Here Are the 7 Mistakes I Kept Seeing.
Documentation is often the first product a developer experiences. Before they see your architecture, your engineering culture, or your code quality, t…
vike-vue-content: A Zero-Boilerplate Docs Framework Built on Vike + Vue
If you've ever built a documentation site with Vue, you know the drill: Write a +Page.vue for every route Manually wire up Markdown loaders Set up cod…
Your README Is More Than Documentation
Most open source projects don't fail because of bad code. A few years ago, I thought a good project would naturally attract users if the code was soli…
What it takes to build docs worth reading
Treating docs as a product When documentation lives as an afterthought, it shows. Pages drift out of date, examples break quietly, and release notes s…
The Only API Documentation Template Your Team Actually Needs
Last week, I watched a senior dev spend 45 minutes just trying to figure out if an API endpoint was deprecated or not. He had to dig through Slack thr…
Architecture Drift Detection: Keep Your Code Aligned with Design
Somewhere in your organization, there's an architecture diagram that's wrong. Maybe it shows a microservice that was merged into another six months ag…
Reverse Engineer Any Database into dbdiagram.io, PlantUML, Mermaid, or QuickDBD - Then Keep Designing
Most database diagram tools stop at documentation. They connect to your database, inspect the schema, and generate a report or a picture. That is usef…
Your Terraform estate documents itself now: meet iac-cartographer
"Wait: How many Terraform repos do we actually have? And what's in them?" If that question makes you wince, this post is for you. It started as a bori…
Docstrings vs Markdown Docs: What Should Developers Actually Write?
Every developer hits this wall eventually. You know you should document your code. You've heard the lectures. But then you're staring at your project …
Everyone Needs a README for Their Life
"If you don't document it, the next person inherits your confusion—and that next person is often you, six months later, in a different city, wondering…
Capture the Reasoning Path, Not the Final State
Two files, one discipline, and a measured 10-13% of my Claude Code budget. A while back, mid-session with Claude Code, I typed a pushback in the kind …
Introducing Truthmark 1.4.0: Git-native truth workflows for AI coding agents
AI coding agents are getting good at changing code. That creates a new problem. The code changes, but the repository often stops telling the truth. Th…
Building ARCHITECTURE.md Files That Prevent AI From Making Silent Architectural Decisions
Building ARCHITECTURE.md Files That Prevent AI From Making Silent Architectural Decisions A few weeks into our experiment with an AI coding assistant,…
Capture the decision at commit-time, or lose it forever
How many times have you faced code nobody can explain anymore? A strange architectural choice. A cache TTL of 17 minutes that nobody can justify. A wo…
Enterprise Architecture Diagrams That Actually Scale
Your service is down. Latency spiked to 30 seconds. You pull up the architecture wiki, desperate to trace the failure path, and find... a messy Visio …
Cursor: Rules, Project Docs, and Context That Actually Help the Model
This post was created with AI assistance and reviewed for accuracy before publishing. Cursor can use project rules and documentation to steer behavior…