Designing for people who arrive later

A clever shortcut becomes a burden when the reason for it disappears with the person who wrote it. I document the constraint that justified unusual code, not merely what the code does. Future maintainers can then remove the workaround when the constraint changes.

Comments that narrate every line age quickly; decision records survive longer. Good maintenance leaves permission to simplify, not an obligation to preserve complexity. The maintenance note describes the user need and the interface relationship the change must preserve, then gives tests for any future replacement.

A maintainer arriving years later can update a dependency or component without copying obsolete implementation details. The design is handed over as criteria and constraints, allowing adaptation while protecting behaviour that users and other systems still rely on. Each workaround carries an expiry condition and the problem it originally solved.

A successor can simplify the system confidently because the documentation gives criteria for adaptation instead of turning temporary complexity into permanent architecture.

New planting is often judged in its first season, although the real design emerges through maintenance and succession. I specify which relationships should persist and where gardeners may substitute species. A rigid planting list can fail after climate or disease changes.

Future care is part of design, not a separate operational phase. The plan should guide adaptation without pretending to predict every mature condition. The planting plan identifies desired shade, seasonal sequence, soil cover and habitat role separately from the species currently providing them.

A later gardener can substitute a plant after disease or climate change while preserving the relationship the composition was designed to create. Future care is therefore guided without pretending that one species list can predict every mature condition. The planting plan fixes relationships among shade, soil and succession while allowing individual species to be replaced.

Maintenance is therefore part of the design brief, not an afterthought imposed after the first season has been photographed.

A house style helps many writers work together, but undocumented exceptions can look like mistakes to a later editor. I record why a deliberate inconsistency was retained when it serves voice, chronology or argument. The note should be shorter than the future confusion it prevents.

Excessive explanation can make revision timid, so I distinguish principles from one-off preferences. Editorial continuity depends on knowing which differences carry meaning. Beside a deliberate inconsistency, I leave a short note naming the contribution it makes to voice, chronology or argument.

A later editor can preserve the difference instead of correcting it into house style, yet the specificity of the reason prevents every personal preference from becoming precedent. The exception survives because its function is documented, not because deviation is automatically valued. An intentional departure from house style is marked with its rationale and the principle it serves.

Later editors can distinguish a portable rule from a preference tied to one commission, avoiding the automatic correction of meaningful variation.

A policy often reaches people through guidance written after the political decision has been made. I test whether someone unfamiliar with the debate can identify both the intended action and the route for challenging an error. Future users need more than background; they need procedural handles.

A document that explains purpose but hides appeal mechanisms converts interpretation into obedience. Durable policy communication includes how correction will occur. Guidance is tested by someone who did not attend the policy debate.

I ask that reader to locate the required action, the evidence behind it and the route for challenging an incorrect decision. A later analyst can see whether future users have procedural control or are merely being told the institution’s purpose. Correction is designed into communication rather than added after failure.

Guidance includes a route for contesting an incorrect application, not merely an account of the policy’s purpose. A newcomer should be able to find who can revise the decision and what evidence that person is required to consider.