{"action":"created","issue":{"url":"https://api.github.com/repos/mozilla/data-review/issues/10","repository_url":"https://api.github.com/repos/mozilla/data-review","labels_url":"https://api.github.com/repos/mozilla/data-review/issues/10/labels{/name}","comments_url":"https://api.github.com/repos/mozilla/data-review/issues/10/comments","events_url":"https://api.github.com/repos/mozilla/data-review/issues/10/events","html_url":"https://github.com/mozilla/data-review/issues/10","id":355595107,"node_id":"MDU6SXNzdWUzNTU1OTUxMDc=","number":10,"title":"[wiki] Users have expressed confusion about Step 1","user":{"login":"chutten","id":1123376,"node_id":"MDQ6VXNlcjExMjMzNzY=","avatar_url":"https://avatars1.githubusercontent.com/u/1123376?v=4","gravatar_id":"","url":"https://api.github.com/users/chutten","html_url":"https://github.com/chutten","followers_url":"https://api.github.com/users/chutten/followers","following_url":"https://api.github.com/users/chutten/following{/other_user}","gists_url":"https://api.github.com/users/chutten/gists{/gist_id}","starred_url":"https://api.github.com/users/chutten/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chutten/subscriptions","organizations_url":"https://api.github.com/users/chutten/orgs","repos_url":"https://api.github.com/users/chutten/repos","events_url":"https://api.github.com/users/chutten/events{/privacy}","received_events_url":"https://api.github.com/users/chutten/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-08-30T13:51:01Z","updated_at":"2018-08-30T18:11:48Z","closed_at":null,"author_association":"COLLABORATOR","body":"Users have come to me for clarification about how to file for Data Collection Review. The topics of confusion usually manifest as questions like\r\n\r\n* \"So am I supposed to just copy the form?\"\r\n* \"Can I reuse the bug where I'm adding the probe?\"\r\n* \"Does bugzilla support markdown now?\"\r\n\r\nI think this stems from a couple of wording choices and some perceived rigidity. For instance \"clone\" means something in git, so its use for the form suggests that users should fork the repo or create a gist or something, which is in conflict with the following substeps.\r\n\r\nI propose a rewording:\r\n\r\nTo request a review, Data Review requesters require the following: \r\n\r\n* A completed Request Form, documenting what data is to be collected, why Mozilla needs to collect this data, how much data will be collected, and for how long it will be collected:\r\n  * Take [this request](request.md) and fill it out completely (It is in markdown for easy reading of the template, but we understand bugzilla will likely render it as plain text. That's fine.)\r\n* A bug to attach the completed Request Form to:\r\n  * Attach the completed Request Form to the bug, or paste the contents as a comment in the Issue\r\n  * Tip: reuse the bug you filed to add the collection code\r\n* A notification so the Data Steward knows it's time to review your Request Form:\r\n  * r? the attachment, ni? the bug, or @ the Data Steward on the GitHub Issue\r\n  * If the Data Steward doesn't get back to you within a couple of days, please email [the list](mailto:fxdatastewardsorwhatever)\r\n\r\nBikeshed: begin"},"comment":{"url":"https://api.github.com/repos/mozilla/data-review/issues/comments/417415861","html_url":"https://github.com/mozilla/data-review/issues/10#issuecomment-417415861","issue_url":"https://api.github.com/repos/mozilla/data-review/issues/10","id":417415861,"node_id":"MDEyOklzc3VlQ29tbWVudDQxNzQxNTg2MQ==","user":{"login":"fmarier","id":167821,"node_id":"MDQ6VXNlcjE2NzgyMQ==","avatar_url":"https://avatars2.githubusercontent.com/u/167821?v=4","gravatar_id":"","url":"https://api.github.com/users/fmarier","html_url":"https://github.com/fmarier","followers_url":"https://api.github.com/users/fmarier/followers","following_url":"https://api.github.com/users/fmarier/following{/other_user}","gists_url":"https://api.github.com/users/fmarier/gists{/gist_id}","starred_url":"https://api.github.com/users/fmarier/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fmarier/subscriptions","organizations_url":"https://api.github.com/users/fmarier/orgs","repos_url":"https://api.github.com/users/fmarier/repos","events_url":"https://api.github.com/users/fmarier/events{/privacy}","received_events_url":"https://api.github.com/users/fmarier/received_events","type":"User","site_admin":false},"created_at":"2018-08-30T18:11:48Z","updated_at":"2018-08-30T18:11:48Z","author_association":"MEMBER","body":"Since you asked for my opinion on the colour of that fancy new bikeshed :)\r\n\r\n> (It is in markdown for easy reading of the template, but we understand bugzilla will likely render it as plain text. That's fine.)\r\n\r\nMaybe it should just be in plaintext to start with. It's kind of annoying having to look through the table markup when people use it. It would also avoid people having to rename the file manually to .txt so that it gets displayed inline in bugzilla."}}
{"actor":{"display_login":"fmarier"}}