useful tools for communicating software changes, planned or completed
pictures
- sequence diagrams
- entity relationship diagrams, i.e. data schemas
- data flow diagrams (boxes and arrows)
code
- code snippets
- pseudocode
- example diffs of pseudocode
text
- recipe steps (numbered lists w/ steps added/crossed out)
- structure with headings. make text easier to scan for key parts, and read non-linearly