DEVBLUEPRINTS

Blog

  • About the blog
  • Archive
  • Newsletter
  • RSS

Legal

  • Terms & Privacy
  • Contact
  • About me

Subscribe to the Newsletter

I authorize communications by email or other means and agree to the Terms and Privacy Policy

 

Blog
  • About the blog
  • Archive
  • Newsletter
  • RSS
Legal
  • Terms & Privacy
  • Contact
  • About me
© 2026 All rights reserved — Designed and built withFooter Heartpor Ednaldo Luiz
Architecture Decision Records (ADR): record decisions without creating bureaucracy
System Design•20 min read

Architecture Decision Records (ADR): record decisions without creating bureaucracy

Code shows how the system works, but it rarely explains why it took that shape. Learn to use ADRs to preserve context, alternatives, and trade-offs without turning architecture into bureaucracy.

Foto de Ednaldo Luiz
Ednaldo Luiz•August 22, 2026

Latest posts

Freshly published articles, updated whenever new content drops.

12
Requirements Engineering: from vague request to verifiable requirement
software engineering
requirements
best practices

Requirements Engineering: from vague request to verifiable requirement

Bad software does not always start with bad code. Often, it starts with a poorly understood problem. See how clear requirements reduce rework and lead to better architecture decisions.

System Design
00
Anti-Corruption Layer: isolate your application from external models
software architecture
integration patterns
+2

Anti-Corruption Layer: isolate your application from external models

Third-party contracts, statuses, and errors spread through the codebase little by little. Learn how an Anti-Corruption Layer isolates this coupling and when it is worth the cost.

System Design
00
How to estimate storage growth with writes, replication, and retention
storage
capacity planning
systems design
+3

How to estimate storage growth with writes, replication, and retention

A practical guide to calculating storage from writes per second, average data size, replication factor, and retention time before volume becomes cost or bottlenecks in production.

System Design
00
Solutions Architecture: what it is, where it acts, and why it creates confusion
architecture
solutions architecture
+2

Solutions Architecture: what it is, where it acts, and why it creates confusion

Understand what Solutions Architecture really is, where this role fits among other architecture disciplines, and why its scope is still so often misunderstood in practice.

System Design
00
Enterprise Software: what changes when the product needs to operate as a platform
software
architecture
enterprise
platform

Enterprise Software: what changes when the product needs to operate as a platform

Scale, availability, compliance, and integration stop being “extras” and become survival requirements. A practical guide to the trade-offs and decisions that separate a common system from an enterprise platform.

System Design
00
Not every bug is an incident — and not every incident is a bug
software
incident management
bugs
sre
+1

Not every bug is an incident — and not every incident is a bug

Bugs and incidents are not synonyms. Understand the difference between technical defect and operational impact, and see why the same problem can end up in the backlog or require an urgent production response.

Cloud & DevOps
00

Newsletter

Get practical architecture & system design content

Short weekly briefs with real decisions and trade-offs: Java/backend, cloud, and data-driven intelligent systems. No spam.

I authorize communications by email or other means and agree to the Terms and Privacy Policy

 

Recommended posts

Posts selected for you to explore further.

12
How to estimate storage growth with writes, replication, and retention

How to estimate storage growth with writes, replication, and retention

A practical guide to calculating storage from writes per second, average data size, replication factor, and retention time before volume becomes cost or bottlenecks in production.

June 26, 202614 min
Anti-Corruption Layer: isolate your application from external models

Anti-Corruption Layer: isolate your application from external models

Third-party contracts, statuses, and errors spread through the codebase little by little. Learn how an Anti-Corruption Layer isolates this coupling and when it is worth the cost.

August 02, 202616 min
Architecture Decision Records (ADR): record decisions without creating bureaucracy

Architecture Decision Records (ADR): record decisions without creating bureaucracy

Code shows how the system works, but it rarely explains why it took that shape. Learn to use ADRs to preserve context, alternatives, and trade-offs without turning architecture into bureaucracy.

August 22, 202620 min