Server, crates and docs
As I've had a pretty busy period, I haven't had the chance to post anything new here, and I only managed to get a few things done on the actual codi…
Architecture
⚑ Report a ProblemLatest Architecture news from Tech News
All topics
agents
ai
api
architecture
automation
aws
backend
beginners
career
database
devchallenge
devops
javascript
llm
machinelearning
mcp
news
opensource
performance
productivity
programming
python
react
security
showdev
softwareengineering
systemdesign
tutorial
typescript
webdev
Modeling Waterfront Assets with Shapezo: A Typed Content Pipeline for Docks, Piers, and Wharves
Most port documentation fails for a boring reason: it is unstructured prose about structured things. A dock is a graph. It has a deck, a piling fiel…
Best Data Warehouse Schema Documentation Tools (2026): SQLDBM, dbt, DataHub, Atlan & SchemaSpy Compared
Schema documentation used to be the thing teams promised to do "next sprint" and then never did. In 2026, that excuse doesn't hold up. Warehouses ar…
Specification: Agentic Docs-as-Code Architecture Pipeline
Overview This specification establishes an automated, agent-driven software architecture documentation ecosystem. The framework integrates strict st…
Step 3 — Documentation Generation
Exactly. Step 3 is where we finally produce the human-readable architecture document . The important rule is: Step 3 must not rediscover the archite…
The Globe: Following Your Reasoning Into Other People's Repositories
Keep the Why records why a codebase is the way it is. Decisions can cite decisions in other repositories. The Globe follows those citations outward,…
Implementing Modern Documentation Search for Developer Portals
When developers or users land on a technical portal, their primary goal is to find precise answers quickly. A poorly implemented search bar leads to…
Split Config Docs Into Extracted Keys and Operator-Signed Constraints
Config documentation fails most often when a generated catalog silently absorbs production promises that nobody reviewed. Parser extraction can list…
How i documented a Broken codebase without losing my mind.
If you want to use it straight away | Link here I believe we achieved a point in tech where having a broken codebase that started as an MVP and evol…
Architecture: Write It Down Before Rewriting
Part of the "How to bring order to a project" series — the architecture track. Same context: a growing gamedev project, about twenty services on dif…
All 23 of my line-number citations were wrong, and the coverage check could not notice
A table in my spec cited a source file by line number, 23 rows of it. Every one was off by one or two. The coverage check next to it had been green…
Wabe Labs Is Born, and Building With Blueprints
Entering the third week of my startup adventure has been a deeply rewarding time of solidifying foundations. Things come together to form an officia…
A Practical Release Inventory for OpenVPN Deployments
Cover illustration: Separate desktop-client, server-component and operating-system tiles linked to individual evidence cards, illustrating a softwar…
How to Build a Game Wiki That Never Dies: Designing for Evidence in Fast-Changing Docs
Every game wiki faces the same failure: the build guide said a weapon was "best," the patch changed it, and now a reader must choose between last we…
Why Confluence Cloud turns your SVG into a flat image
Short answer. An SVG file is not only a picture: it can carry links, scripts and references to outside resources. Rendering one live inside a page w…
Source-Bound Docs: Models Restate Files, Humans Own Promises
Model-drafted documentation is useful only when every generated claim maps to a file the repository already owns. Sentences without a source become…
Architecture Docs Always Outdated? Let Code "Grow" Them Automatically
Terrain — prepares the ground so agents don't have to guess where to stand. 🔗 GitHub: https://github.com/sopaco/terrain The Tech Lead's Pain: Docume…
Knowledge Management in CI/CD: How Terrain Automates Document Updates
Terrain — prepares the ground so agents don't have to guess where to stand. 🔗 GitHub: https://github.com/sopaco/terrain The Real Problem in CI/CD Pi…
Launching Docgrity 🚀: Documentation integrity for you, your team, and your agent friends. 🤖
Today I'm launching Docgrity — a tool for finding where your documentation disagrees with itself, before it confuses you or the next AI agent workin…
How Developers Can Influence Brand Visibility in AI Systems
GEO (Generative Engine Optimization) often gets framed as a marketing problem, but a surprising amount of the leverage lives in decisions dev teams…
Four spec standards, one baseline, two different decisions
Two side projects, one developer, an AI assistant on both. You work on them when you can and when you feel like it, for fun. And precisely because i…
Embed Charts in Markdown Without Chart.js: SVG, Data URIs, and What Actually Works
Markdown is great until you want a real chart in a README or docs site. Most people reach for a screenshot, a hosted PNG, or a heavy client library.…
grow-hack: An AI Pipeline That Turns Any GitHub Repo Into Professional Docs in Under a Minute
Every developer has been there: you clone a promising repository, and the README is either missing, three years stale, or says "docs coming soon." E…
Your Migration Guide Is Already Wrong
James Coombs is a design engineer who replaced a migration guide with 49 JSON data files and a handoff playbook. Engineers on four other teams migra…
Deprecation Doesn't Reach the Copies
Originally published on hexisteme notes . I keep my operating judgment in small, versioned files — one file per decision, each with a status, a list…
Internal vs. External Documentation: What Belongs Where
Originally published at https://ninadpathak.com/articles/internal-vs-external-documentation/ . Internal documentation helps your team operate the sy…
What Is Technical Documentation, and What Should It Include?
Originally published at https://ninadpathak.com/articles/what-is-technical-documentation-and-what-should-it-include/ . Technical documentation is th…
A Second Brain Your AI Agent Can Read
Background There are so many details we need to remember in life. Recently I've been working on a legacy project that was written years ago with no…
GFM vs CommonMark vs Pandoc Markdown: Syntax Compared
Markdown looks like one language until the same file renders differently on GitHub, Hugo, Obsidian, or Pandoc. And the problem is not that Markdown…
How I Turned a Technical Writing Team Upside Down...Or, Downside Up?
Every time I think about what happened to me that one beautiful day, I still get goosebumps because that was my whole career shift. I’m sure a lot o…