202107261436 engineering review sessions

• When to use?
  • Senior architect or technical group that needs to review things
  • Solutions heavy in technical debt
  • Lots of unknowns
• Consistent format?
• Documentation?
• Have a facilator?
• Assign a note taker
• Document format:
  • Problem / Proposed Resolution or Solution
  • Action Items
• Present the thinking and make sure aligned on the implementation
• Bad approach: Provide multiple options, as you dig into the solution you can pick which route. This ends with confusion.
  • Generally, 1) If you need it immediately, hack this together; 2)
• Helpful to write out a list of questions and their thoughts on the approach. Share the doc ahead of time.
• Documentation resources:
  • Technical architecture documentation
• When to write documentation