Documenting decisions made via forum

It doesn’t have an answer. (I.e. it’s a generative question in the language of proposal forming (S3 pattern).)

The question is about these two things and whether it would be a good idea to do both, or whether one of them is more important, etc.:

  • Document the exact decisions made via consent. Examples:
    • “Introduce role X with responsibilities A, B, C, …”
    • “Remove role Y and replace it with [something]”
    • “Change »A team members« to »A team member« in the process for consent decisions”
  • Document the things that have been decided, but possibly in a different language, and change them to reflect the decisions made. Examples:
    • A complete list of roles and responsibilities
    • The process for consent decisions, updated to reflect both consent decisisions made about it (1, 2)

An obvious answer would be to document both; however, the second one might not always be possible, or it might require some effort if the documentation must be correct.

Another answer could be to always decide to do certain exact changes to the documentation, i.e. a git patch.