How to explain a technical mechanism, with a bicycle derailleur as the model

What to take away

A mechanism explanation shows how organised parts produce a result. The craft is simplifying without changing what causes what. This guide uses a bicycle rear derailleur because its parts are few, visible and documented in public service guides by a tool maker, Park Tool. For the wider genre, see the guide to science and technology explanatory essays.

Pick the explanation type first

Dennis Jerz of Seton Hill University distinguishes three kinds of technical writing. A mechanism description analyses an object in space and covers its function, appearance and operation. A process description shows how a change takes place over time through a series of stages. Instructions are a kind of process description that focuses on actions the reader takes.

Editorial suggestion: extend that split into four explanation types and choose by the reader's confusion.

One subject can need all four. Title the piece after its main question and use the others in support. The guide to reasoning types explains what counts as sound evidence for the causal row.

Set the output and the boundary

Write one sentence before anything else: this explanation shows how [input] becomes [output] inside [boundary] under [conditions].

For the derailleur, Park Tool's rear derailleur adjustment guide says indexing is the process of lining up the guide pulley with the cogs so that each incremental shift lines up with each cog. That gives a usable output: the position of the guide pulley under a chosen cog. The input is a shifter click that moves the cable by a set amount.

The Stanford Encyclopedia of Philosophy entry on mechanisms in science quotes a standard definition of a mechanism as entities and activities organised to produce regular changes from start to termination conditions, and says its boundaries are fixed by their relevance to the phenomenon. So state what you left out and why:

If the system changes, so does the boundary. Park Tool notes that electronic systems use an electrical signal to trigger a motor that moves the linkage, so a cable-pull explanation does not carry over.

Name parts by what they do

Park Tool's guide to how a rear derailleur works describes a mounting bolt that secures the derailleur to the frame's hanger, and an upper pivot joined to a lower pivot by a linkage that forms a parallelogram. Give the job before the detail:

Jerz's mechanism-description page says to cover function, appearance and operation. The table covers function and appearance. The next section covers operation.

Trace the chain with labelled verbs

Draw arrows first and write prose second. Park Tool's descriptions support steps 1, 2, 3 and 5 for a mechanical (cable) derailleur. Step 4 is an editorial addition, based on Park Tool's instruction to test shifts while pedalling:

Each verb names a physical action. Editorial suggestion: avoid saying the shifter "pushes" the chain, since it moves a cable. Keep the signal and the work in separate sentences: the shifter and cable carry a position command, and the pedalling rider supplies the motion that drags the chain across.

One caution on direction: this description follows the design Park Tool documents, in which the cable pulls the cage inward and a spring pulls it outward. Check the maker's manual for the model you are writing about before generalising.

Break it on purpose: the failure test

A model that cannot predict a plain failure is missing a relation. Park Tool's adjustment guide gives failures that the model above should explain. This is not a repair procedure; follow the manufacturer's instructions for your own bike.

Park Tool's how-it-works guide gives a barrel-adjuster rule that fits the model: turning it counter-clockwise takes up cable slack and moves the guide pulley slightly inward, while clockwise gives slack and moves it outward.

The best causal lesson is in the same article. Many people think the H-limit screw is set correctly, but Park Tool warns that the cable pull may be stopping the derailleur, not the screw, because a spring pulls the derailleur outward while the cable pulls against it. You cannot tell which part is limiting travel until you take the cable out of the equation, which the guide does with the barrel adjuster. That is causal reasoning in miniature: change one factor and watch whether the outcome changes. The SEP entry on causal approaches to scientific explanation describes the same idea as an intervention on the cause.

Park Tool's hanger alignment guide adds that hangers are designed to bend easily, which protects the derailleur and frame in an impact, and that the resulting misalignment generally cannot be fixed by indexing or limit-screw adjustment. After realigning, it says all rear derailleur adjustments should be rechecked. Your model should predict both facts.

Use systems language, then state what you simplified

NASA's systems engineering handbook defines a system as the combination of elements that function together to produce the capability required to meet a need. It adds that the value added by the system as a whole is primarily created by the relationship among the parts. That supports the boundary choice above: the derailleur's output only exists because shifter, cable, housing, cage, chain and cogs are related in a particular way.

Name your simplifications in plain words:

Do not hide exceptions under "basically." Give the central model first, then the condition that breaks it.

Editorial suggestion: test the draft on someone who has never serviced a bike. Ask them to redraw the parts and arrows from memory and to say what happens if the cable slackens. Whatever they reverse or invent is where your explanation distorts. Then reread it using the revision passes, and keep a note of where each fact came from with a claim and source note system.

Sources