{"action":"opened","issue":{"url":"https://api.github.com/repos/red-gate/Tech-Radar/issues/40","repository_url":"https://api.github.com/repos/red-gate/Tech-Radar","labels_url":"https://api.github.com/repos/red-gate/Tech-Radar/issues/40/labels{/name}","comments_url":"https://api.github.com/repos/red-gate/Tech-Radar/issues/40/comments","events_url":"https://api.github.com/repos/red-gate/Tech-Radar/issues/40/events","html_url":"https://github.com/red-gate/Tech-Radar/issues/40","id":376838263,"node_id":"MDU6SXNzdWUzNzY4MzgyNjM=","number":40,"title":"Lightweight Architecture Decision Records","user":{"login":"garethbragg","id":8382756,"node_id":"MDQ6VXNlcjgzODI3NTY=","avatar_url":"https://avatars1.githubusercontent.com/u/8382756?v=4","gravatar_id":"","url":"https://api.github.com/users/garethbragg","html_url":"https://github.com/garethbragg","followers_url":"https://api.github.com/users/garethbragg/followers","following_url":"https://api.github.com/users/garethbragg/following{/other_user}","gists_url":"https://api.github.com/users/garethbragg/gists{/gist_id}","starred_url":"https://api.github.com/users/garethbragg/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/garethbragg/subscriptions","organizations_url":"https://api.github.com/users/garethbragg/orgs","repos_url":"https://api.github.com/users/garethbragg/repos","events_url":"https://api.github.com/users/garethbragg/events{/privacy}","received_events_url":"https://api.github.com/users/garethbragg/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-11-02T14:43:15Z","updated_at":"2018-11-02T14:43:15Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"I notice [lightweight ADRs](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions) are in the _Adopt_ section of [Thoughwork's tech radar](https://www.thoughtworks.com/radar/techniques):\r\n\r\n> Much documentation can be replaced with highly readable code and tests. In a world of evolutionary architecture, however, it's important to record certain design decisions for the benefit of future team members as well as for external oversight. Lightweight Architecture Decision Records is a technique for capturing important architectural decisions along with their context and consequences. We recommend storing these details in source control, instead of a wiki or website, as then they can provide a record that remains in sync with the code itself. For most projects, we see no reason why you wouldn't want to use this technique.\r\n\r\nThis is a practice used by some Redgate teams already.\r\n\r\nShould this be in our techradar? If so, where?\r\n\r\nI'd suggest in the _Techniques_ quadrant, either in _Adopt_ or _Explore_?"}}
{"actor":{"display_login":"garethbragg"}}