Discussion

• Where are comments justified?

• Classes, attributes, methods, code blocks

• What types of comments?

  • Specification: What does this do?
  • Quality level “This is an Evil Hack”
  • Input/Output Assumptions/Calling contract
  • Caller details
  • Non-functional info, e.g. Performance
  • Rationale

Notes: