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