{"action":"created","issue":{"url":"https://api.github.com/repos/racedisparityaudit/ethnicity-facts-and-figures-publisher/issues/887","repository_url":"https://api.github.com/repos/racedisparityaudit/ethnicity-facts-and-figures-publisher","labels_url":"https://api.github.com/repos/racedisparityaudit/ethnicity-facts-and-figures-publisher/issues/887/labels{/name}","comments_url":"https://api.github.com/repos/racedisparityaudit/ethnicity-facts-and-figures-publisher/issues/887/comments","events_url":"https://api.github.com/repos/racedisparityaudit/ethnicity-facts-and-figures-publisher/issues/887/events","html_url":"https://github.com/racedisparityaudit/ethnicity-facts-and-figures-publisher/pull/887","id":387983549,"node_id":"MDExOlB1bGxSZXF1ZXN0MjM2MzUyNDc5","number":887,"title":"Lightweight architecture decision records","user":{"login":"samuelhwilliams","id":2920760,"node_id":"MDQ6VXNlcjI5MjA3NjA=","avatar_url":"https://avatars1.githubusercontent.com/u/2920760?v=4","gravatar_id":"","url":"https://api.github.com/users/samuelhwilliams","html_url":"https://github.com/samuelhwilliams","followers_url":"https://api.github.com/users/samuelhwilliams/followers","following_url":"https://api.github.com/users/samuelhwilliams/following{/other_user}","gists_url":"https://api.github.com/users/samuelhwilliams/gists{/gist_id}","starred_url":"https://api.github.com/users/samuelhwilliams/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/samuelhwilliams/subscriptions","organizations_url":"https://api.github.com/users/samuelhwilliams/orgs","repos_url":"https://api.github.com/users/samuelhwilliams/repos","events_url":"https://api.github.com/users/samuelhwilliams/events{/privacy}","received_events_url":"https://api.github.com/users/samuelhwilliams/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-12-05T22:59:59Z","updated_at":"2018-12-07T13:03:07Z","closed_at":null,"author_association":"CONTRIBUTOR","pull_request":{"url":"https://api.github.com/repos/racedisparityaudit/ethnicity-facts-and-figures-publisher/pulls/887","html_url":"https://github.com/racedisparityaudit/ethnicity-facts-and-figures-publisher/pull/887","diff_url":"https://github.com/racedisparityaudit/ethnicity-facts-and-figures-publisher/pull/887.diff","patch_url":"https://github.com/racedisparityaudit/ethnicity-facts-and-figures-publisher/pull/887.patch"},"body":" ## Summary\r\nWe need a way to record decisions (and the conversations around those\r\ndecisions) in a durable, discoverable format. Architecture Decision\r\nRecords (ADRs) are a way to record \"significant\" decisions made about\r\nthe technical architecture of our service, as well as the context around\r\nthose decisions, any alternatives that were considered or explored, and\r\nthe pros/cons that might be worth remembering.\r\n\r\nWe don't want to introduce a lot of complexity, so it seems beneficial\r\nto keep this process very lightweight. In that vein, we will look at the\r\nLightweight Architecture Decision, as discussed here:\r\n\r\nhttps://www.thoughtworks.com/radar/techniques/lightweight-architecture-decision-records\r\nhttp://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions\r\n\r\nThis does not involve an undue burden of detailed documentation, but\r\nrecommends preserving, concisely, the context of the problem, the\r\ndecision taken, the alternatives considered, and the consequences of the\r\nchosen solution."},"comment":{"url":"https://api.github.com/repos/racedisparityaudit/ethnicity-facts-and-figures-publisher/issues/comments/445226414","html_url":"https://github.com/racedisparityaudit/ethnicity-facts-and-figures-publisher/pull/887#issuecomment-445226414","issue_url":"https://api.github.com/repos/racedisparityaudit/ethnicity-facts-and-figures-publisher/issues/887","id":445226414,"node_id":"MDEyOklzc3VlQ29tbWVudDQ0NTIyNjQxNA==","user":{"login":"samuelhwilliams","id":2920760,"node_id":"MDQ6VXNlcjI5MjA3NjA=","avatar_url":"https://avatars1.githubusercontent.com/u/2920760?v=4","gravatar_id":"","url":"https://api.github.com/users/samuelhwilliams","html_url":"https://github.com/samuelhwilliams","followers_url":"https://api.github.com/users/samuelhwilliams/followers","following_url":"https://api.github.com/users/samuelhwilliams/following{/other_user}","gists_url":"https://api.github.com/users/samuelhwilliams/gists{/gist_id}","starred_url":"https://api.github.com/users/samuelhwilliams/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/samuelhwilliams/subscriptions","organizations_url":"https://api.github.com/users/samuelhwilliams/orgs","repos_url":"https://api.github.com/users/samuelhwilliams/repos","events_url":"https://api.github.com/users/samuelhwilliams/events{/privacy}","received_events_url":"https://api.github.com/users/samuelhwilliams/received_events","type":"User","site_admin":false},"created_at":"2018-12-07T13:03:07Z","updated_at":"2018-12-07T13:03:07Z","author_association":"CONTRIBUTOR","body":"Done @frankieroberto 👍 "}}
{"actor":{"display_login":"samuelhwilliams"}}