Great article! One thing I find important regarding architectural or design decisions is to document the "why" something was done, rather than what was done. There's a style of this documentation called ADR (Architectural Decision Records). Though I don't follow this diligently, writing down especially non-standard design decisions helps others a lot!