Skip to main content

6 posts tagged with "best-practices"

View All Tags

The Validation Nightmare: When Type Safety Goes Wrong

· 5 min read
Max Kaido
Architect

Today, I want to share a particularly frustrating development experience that perfectly illustrates how well-intentioned engineering practices can lead to significant problems when misapplied. Our team encountered a maddening issue in our Mercury dashboard where comparison trail data was present in the backend response but consistently failed to display in the UI.

FDD Best Practices: Learning from Anti-Patterns

· 3 min read
Max Kaido
Architect

During a recent code review of our shadow portfolio feature, we discovered a concerning pattern where FDD documentation was artificially inflated by duplicating TypeScript type definitions. This experience provides valuable lessons about what makes FDD documentation effective - and what doesn't.

The Holy War: Git History Preservation vs The Evil of Squashing

· 3 min read
Max Kaido
Architect

In the ancient scrolls of software development, there exists a tale of two opposing forces: the Noble Order of Git History Preservers and the Dark Legion of Commit Squashers. Today, we delve into this epic saga that continues to shape the destiny of codebases across the realms.

The Dark Arts of Squashing

In the shadows lurk those who practice the dark art of squashing commits. They tempt developers with promises of a "clean history" and "simplified logs." But at what cost? Every squashed commit is a story lost to the void, a context erased from existence, a debugging trail gone cold.

TypeScript Declaration Pitfalls: 10 Costly Decisions to Avoid

· 4 min read
Max Kaido
Architect

When building a TypeScript project, type declarations are your first line of defense against bugs and maintainability issues. However, certain type declaration patterns can actually work against you, creating technical debt and making your codebase harder to maintain. Let's explore 10 specific anti-patterns we've identified in our analysis of real-world TypeScript projects.