Glossary · Phase 11 · Professional practice
Imperative mood
Writing as a command, such as "Add retries". The convention for commit message subjects.
Try it now
The diff shows what changed. The message is for why.
Learn it properly
Writing for engineers · READMEs, design docs, commit messages and bug reports people can act on. About 35 minutes.
Other terms from the same lesson
- architecture decision record: A short note of one significant decision: its context, the decision and its consequences.
- design doc: A document written before building something big: the problem, goals, non-goals, proposal, alternatives and risks.
Never trained an AI?
Teach a small one to write, right in your browser. It takes about 20 seconds and needs no account.