Non-functional criteria for framework choices

Published on June 13, 2025

After many years of watching teams succeed and fail with technology choices, I've learned something interesting: the features rarely determine success.

"It's not what you look at that matters, it's what you see."

Henry David Thoreau

Introduction

Have you ever been in a meeting where someone pulls up a spreadsheet comparing frameworks and checking off feature boxes?

"Framework A has built-in database access, framework B supports Jira. Framework C has the best memory benchmarks."

However, sometimes, human factors can matter way more than any tech specs.

The expertise dilemma

Your team knows Technology A inside and out. They've built a dozen applications with it, debugged its quirks, and developed their own patterns and best practices.

Then the new framework evaluation begins, and suddenly everyone's fascinated by Technology B's smaller bundle sizes or C's gentler learning curve.

But here's the catch: your Technology A expertise is worth more than any performance gain you'll get from switching.

I've seen teams lose months rewriting perfectly functional applications in "better" frameworks, only to end up with worse code that nobody (including the people who wrote the code) really understands.

Your team's deep knowledge of a framework's gotchas, debugging techniques, and optimization strategies is an asset that's nearly impossible to quantify and quite expensive to replace.

The documentation dilemma

Every framework claims to have excellent documentation.

Documentation quality can actually vary a whole lot depending on what you want to do. Most frameworks excel at getting you started but leave you stranded when you need to do something complex. Others have comprehensive references but just blatantly assume you already know everything.

The real test isn't whether the documentation exists—it's whether your team can find answers when they are stuck two days before the deadline.

The community factor

A framework's community isn't just about Stack Overflow answers. It's about the ecosystem of tools, plugins, and shared solutions that develop around popular choices.

When you choose a framework with a smaller community, you might get fewer resources which in turn means that you're signing up to solve more problems from scratch.

But there's an interesting middle ground: inner source frameworks.

Inner source to the rescue?

These are tools developed internally by your company using open source practices. Instead of posting questions on Stack Overflow, you can walk over to a maintainer's desk. Instead of waiting for a GitHub issue to be prioritized by strangers, you can talk directly to the team.

With frameworks like this, the experience can be remarkably different. Bug fixes happen in days and feature requests are evaluated by people who understand your business context. Documentation gets written by people who know exactly what problems you're trying to solve.

Of course there can be trade-offs as well.

You're betting on your internal team's long-term commitment and expertise. If that team gets reorganized or their priorities shift, you might find yourself maintaining a framework nobody else in the world uses.

But when it works, inner source can give you the best of both worlds: the...