# A Door Left Ajar

An interface is a promise about how to knock. The notes beside it say which bell to press, what to bring, and what you may expect back. The name api-docs.md sounds technical, yet the feeling under it is old and simple. Someone took the time to explain a system so a stranger would not have to guess.

## The courtesy of being clear

Clarity is a form of welcome. When a tool describes its own habits in plain words, it treats the next person as a guest rather than an intruder. You do not need every room. You need to know which ones are open, and how to ask without embarrassment.

A good note does three quiet things:
- It says what is possible.
- It says what is not.
- It stays honest when something changes.

That honesty matters more than polish. A slightly plain explanation that remains true will serve longer than a lovely one that quietly goes stale.

## What a plain file remembers

The ending of the name is almost humble. It points toward a text file, the kind a person can open and read without ceremony. In a world of flashing panels, a readable page is a small act of trust. It assumes you will sit with it. It assumes you are capable of understanding if someone will only speak straight.

I think of a neighbor who labels the spare key and writes, on a card, how the old heater behaves when the nights turn cold. Nothing grand. Just care, stored where it can be found on a tired evening.

## A date on the margin

Today is the twenty-seventh of October, 2026. The page does not need to know the weather. Still, every explanation is written on some particular day, by someone who chose to leave a light in the hall. Tomorrow another reader will arrive with a question. The note will be waiting, patient as a porch.

*Understanding begins when someone bothers to say how the door works.*