payload: {"action":"created","issue":{"url":"https://api.github.com/repos/libero/community/issues/23","repository_url":"https://api.github.com/repos/libero/community","labels_url":"https://api.github.com/repos/libero/community/issues/23/labels{/name}","comments_url":"https://api.github.com/repos/libero/community/issues/23/comments","events_url":"https://api.github.com/repos/libero/community/issues/23/events","html_url":"https://github.com/libero/community/issues/23","id":494093444,"node_id":"MDU6SXNzdWU0OTQwOTM0NDQ=","number":23,"title":"RFC: Discovery documents","user":{"login":"giorgiosironi","id":160299,"node_id":"MDQ6VXNlcjE2MDI5OQ==","avatar_url":"https://avatars3.githubusercontent.com/u/160299?v=4","gravatar_id":"","url":"https://api.github.com/users/giorgiosironi","html_url":"https://github.com/giorgiosironi","followers_url":"https://api.github.com/users/giorgiosironi/followers","following_url":"https://api.github.com/users/giorgiosironi/following{/other_user}","gists_url":"https://api.github.com/users/giorgiosironi/gists{/gist_id}","starred_url":"https://api.github.com/users/giorgiosironi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/giorgiosironi/subscriptions","organizations_url":"https://api.github.com/users/giorgiosironi/orgs","repos_url":"https://api.github.com/users/giorgiosironi/repos","events_url":"https://api.github.com/users/giorgiosironi/events{/privacy}","received_events_url":"https://api.github.com/users/giorgiosironi/received_events","type":"User","site_admin":false},"labels":[{"id":860316154,"node_id":"MDU6TGFiZWw4NjAzMTYxNTQ=","url":"https://api.github.com/repos/libero/community/labels/rfc","name":"rfc","color":"569037","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":6,"created_at":"2019-09-16T14:39:37Z","updated_at":"2019-09-17T08:47:55Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"# Problem\r\n\r\nLibero product features and architectural choices often go through a period of discovery where specifications can be produced and implementation options can be evaluated.\r\n\r\nThe process and its output can benefit from the standardization of [*discovery documents*](https://docs.google.com/document/d/1bHxwpGdSi8649NKijGCH_iou07mz6O3lp7OTJNJAOpg/edit) that enable collaboration by being shared between team members, across teams, and outside of eLife.\r\n\r\n# Suggestion\r\n\r\n- Always track discovery work in at least one dedicated Github issue.\r\n- Prefix Google Docs discovery documents titles with `Discovery document:`\r\n- Move them into the single [`Libero` shared drive](https://drive.google.com/drive/u/1/folders/0AC6f8fXdeXmMUk9PVA).\r\n- Link them from the relevant Github issue.\r\n- Establish a timebox in calendar time at the start of the discovery activity.\r\n- Organize in questions and answers; some of the answers are allowed to be assumption if clearly stated that they are.\r\n- Link to a [Github milestone](https://github.com/libero/publisher/milestone/20) if applicable.\r\n- Add a `TL;DR` section at the top before closing the document at the end of the timebox.\r\n\r\n# Concerns\r\n\r\n- A timebox helps limiting analysis time to favor prototyping and actual implementation.\r\n- Replenishment meetings are a possibility for choosing the lenght of the timeboxes.\r\n- Timeboxes are measured in calendar time so they need to take into account the percentage of time that is allocated to other tasks from the people that work on the discovery.\r\n- Github milestones may not exist if the discovery is related to an aspect of the product or to architecture rather than to a particular feature.\r\n- There is no explicit way to track the closure of a document on the document itself."},"comment":{"url":"https://api.github.com/repos/libero/community/issues/comments/532125256","html_url":"https://github.com/libero/community/issues/23#issuecomment-532125256","issue_url":"https://api.github.com/repos/libero/community/issues/23","id":532125256,"node_id":"MDEyOklzc3VlQ29tbWVudDUzMjEyNTI1Ng==","user":{"login":"Melissa37","id":6051876,"node_id":"MDQ6VXNlcjYwNTE4NzY=","avatar_url":"https://avatars2.githubusercontent.com/u/6051876?v=4","gravatar_id":"","url":"https://api.github.com/users/Melissa37","html_url":"https://github.com/Melissa37","followers_url":"https://api.github.com/users/Melissa37/followers","following_url":"https://api.github.com/users/Melissa37/following{/other_user}","gists_url":"https://api.github.com/users/Melissa37/gists{/gist_id}","starred_url":"https://api.github.com/users/Melissa37/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Melissa37/subscriptions","organizations_url":"https://api.github.com/users/Melissa37/orgs","repos_url":"https://api.github.com/users/Melissa37/repos","events_url":"https://api.github.com/users/Melissa37/events{/privacy}","received_events_url":"https://api.github.com/users/Melissa37/received_events","type":"User","site_admin":false},"created_at":"2019-09-17T08:47:55Z","updated_at":"2019-09-17T08:47:55Z","author_association":"NONE","body":"I assumed the owner to the doc always have the flexibility to change the setting on it, even if it belongs in a public folder. I think we do this on JATS4R"}}
other: {"actor":{"display_login":"Melissa37"}}