Software · The Commit
Explain a change to a future reader
Treat a commit message as a record of intent and consequence. Practice with an invented change, without editing a real repository.
Try this
Describe the problem, the change and the expected behavior in three sentences. Add the check that would show it worked.
Reflect
What decision would otherwise disappear from the record?
Take it further · optional follow-up
Write a follow-up note for a fictional reversal of the change. Explain which assumption proved wrong and what evidence should travel with that decision.
Compare with another activity · Conservation
The Archive: Describe how something can be found →Connect this activity with other subjects
Follow a question through three activities, with a worked example and a worksheet for your observations.
- Leave a useful record →
Create information that another person can understand and return to.
This topic is activity 1 of 3.
Prepared study prompt · not an editor-reviewed research article
