Engineering notes
Tutorials that record what was actually run
Software engineering notes with versions and a tested-on date
In this issue
-
A Framework for Evaluating LLM-Powered Features Before Production
A practical checklist for deciding whether an LLM feature is ready to ship—covering task fit, evaluation design, safety, cost, and operational readiness.
-
Understanding Idempotency in HTTP APIs
What idempotent HTTP methods mean in practice, why retries depend on them, and how to design safe POST endpoints with idempotency keys.
-
What Is a CRDT?
Conflict-free Replicated Data Types let multiple replicas update shared state without locking—and still converge to the same result.
-
Type-Safe Environment Variables in Node.js 22 with TypeScript 5.x
Parse and validate process.env at startup with TypeScript 5.x so missing or malformed configuration fails fast instead of at runtime in production.
-
How Engineering Teams Should Read Official Release Announcements
Release notes bury breaking changes in bullet points. Here is a repeatable method to extract what matters for your stack before you upgrade.
-
Mastering Large Codebases with ripgrep, fd, and jq
A practical terminal workflow for exploring unfamiliar repositories—fast text search, file discovery, and JSON filtering without leaving the shell.
-
Understanding Content Security Policy (CSP)
CSP tells browsers which scripts, styles, and connections are allowed on your site—a defense-in-depth layer against XSS and data exfiltration.
-
Designing Reliable Evaluation Sets for LLM Features
Explore the key considerations and methodologies for designing reliable evaluation sets that effectively assess the features of large language models.
-
A Practical Checklist for Reviewing Cloud Service Boundaries
Reviewing cloud service boundaries is crucial for maintaining effective cloud management. This checklist provides practical steps to evaluate and ensure clear boundaries.
-
How to Diagnose Layout Shift Without Guessing
Learn how to effectively diagnose layout shifts in your web projects without resorting to guesswork. This guide provides practical steps to identify and address layout issues.
-
Common Mistakes in Designing REST APIs
Designing a REST API involves several critical considerations to ensure it is robust and efficient. This article explores common mistakes made during the design process and offers guidance on how to avoid them.
-
Where to Start Learning Docker?
Discover the essential concepts of Docker, including containers, images, Dockerfiles, and more. Learn how to avoid common beginner mistakes.
-
PostgreSQL vs MongoDB: Which Database to Use for Your Project?
Explore the differences between PostgreSQL and MongoDB, including data models, transaction needs, and performance, to determine the best fit for your project.