← Ideas

Clean URLs Are an Application Decision

Routes should describe content rather than storage files.

Routes should describe content rather than storage files. The useful question is not whether the idea sounds persuasive. It is whether it helps someone understand the work, make a decision, or complete a task with less friction.

What is happening

A public address ending in a filename exposes an implementation detail and makes later content changes harder to manage.

This tends to become visible at the boundary between the organization and the person encountering it for the first time. Internal familiarity hides effort that remains obvious to a customer, reader, applicant, or collaborator.

A practical response

Let the application own canonical routes, preserve deliberate compatibility paths, and keep the source document location private.

The aim is a smaller, clearer system: one source for the record, one visible hierarchy, and one next action that behaves as expected. That approach improves the immediate page and makes later application or database work easier to add without rebuilding the public surface.