unvt / adr

Architecture Decision Record repository as GitHub Issues

MIT License

3 stars 0 forks source link

ADR: ADRを書いて共有する #2

Open hfu opened 2 years ago

hfu commented 2 years ago

ADRを書いて共有する

date: 2022-11-14 status: proposed

Context

設計判断がドキュメントされていないことにより、説明を繰り返している状況がある。
設計判断がドキュメント化されて形式知になっていないので、判断自体のクオリティも限定的である。

Decision

Architectural Decision Record を GitHub Issues に気軽に書いていけるようにする。
GitHub Issue Template を用いるなどして、URL 付きの ADR を容易に作れるようにする。

Consequences

ADR が蓄積される。
結果として DWG7 on Smart Maps のカルチャーが醸成される。
Smart Maps Meetup https://github.com/UNopenGIS/7/issues/27 でも話題にできる。