Skip to content
← Learning guide

The Bug

← Back to study results
Other download formats

Illustrated study

Keeping evidence of what went wrong

A computer logbook turns an interruption into a record someone else can inspect.

A ruled logbook page containing handwritten times, calculations and relay notes, with a moth taped beside the entry for relay 70, panel F.

Figure 1 · 9 September 1947 (log entry)

Mark II logbook with a moth found in a relay

Look beyond the moth: times, tests and component names make the interruption traceable. The Mark II team preserved a physical cause of trouble alongside their notes. Engineers already used the word ‘bug’ for faults before this event. What would you record about a problem so someone else could investigate it without starting over?

Mark II operators; U.S. Navy photograph · Naval History and Heritage Command · object held by the Smithsonian
NH 96566-KN · Courtesy Naval Surface Warfare Center, Dahlgren, Virginia · Navy reproduction via Wikimedia Commons

View full size ↗Download image
Collection record and reuse rights

Display copies are resized and compressed. Source and license links apply to the image above.

Explore more museum and archive collections →

Software · The Bug

Make a report reproducible

Use a harmless fictional bug to practice writing a report another person can follow. Separate the symptom from your theory of the cause.

Try this

Write expected behavior, actual behavior and the shortest steps to reproduce. Note environment details and omit private data.

Reflect

Which missing detail would make the report hardest to investigate?

Take it further · optional follow-up

Have a reader follow your fictional reproduction steps on paper. Remove unnecessary steps and identify the exact point where expected and actual behavior diverge.

Compare with another activity · Conservation

The Field Note: Write for a later comparison →
Connect this activity with other subjects

Follow a question through three activities, with a worked example and a worksheet for your observations.

  • Choose a useful test →

    Connect an aim to a question and a way of learning whether something works.

    This topic is activity 3 of 3.

Prepared study prompt · not an editor-reviewed research article