Blog Posts

Latest articles and insights

A practical method for finding and improving the code paths that shape service latency.

The .NET Hot Path Playbook: Performance Without Guesswork

Razvan Mares7 min read

Performance work in .NET is rarely about discovering a single magical API. It is about learning to recognize *hot paths*: the small pieces of code executed so often, or under enough contention, that t...

.NETef-corecsharp+2
A practical operating model for Argo CD and Flux on resource-conscious Kubernetes clusters.

Your Cluster Should Read Git: A Lean Reconciliation Pattern for k3s

Razvan Mares8 min read

A small k3s cluster does not need a miniature enterprise platform. It needs a dependable way to answer one question: > What should be running here right now? GitOps turns that question into a file l...

ci-cdgitlinux+3
A practical design for testing queue-backed counters from message publication to the user interface.

E2E Queue Count Testing: Proving Eventual Consistency Without Flaky Tests

Razvan Mares8 min read

A queue count looks like the smallest possible product feature: place work on a queue, show the number somewhere in the application, and verify that the number changes. In an end-to-end test, it beco...

PostgreSQLci-cd.NET+2
Design end-to-end tests that validate real user outcomes without becoming a brittle maintenance burden.

The Second E2E Topic: Turning Browser Tests Into Release Evidence

Razvan Mares9 min read

End-to-end testing is often introduced as the final safety net: open a browser, click through an application, and confirm that the important path works. That description is accurate, but incomplete. ...

GitHub Actionsci-cd.NET+2
Use architecture, tests, tooling, and documentation to turn a codebase into a better AI collaborator.

Improve Claude by Making Your Repository Easier to Read

Razvan Mares8 min read

Claude does not need a more elaborate prompt for every task. Often, it needs a repository that explains itself. That distinction matters. Developers frequently treat AI output quality as a conversati...

GitHub Actionsci-cdTypeScript+2
A practical guide to modeling finite domains with compiler-enforced alternatives.

Beyond Enums: C# Unions and Closed Classes in .NET 11 Preview

Razvan Mares8 min read

Most C# domain models begin with classes, inheritance, and enums. That combination is familiar, flexible, and often good enough. It also leaves an important gap: many business concepts are not merely ...

.NETef-corecsharp+1