{"action":"created","issue":{"url":"https://api.github.com/repos/ipfs/pm/issues/139","repository_url":"https://api.github.com/repos/ipfs/pm","labels_url":"https://api.github.com/repos/ipfs/pm/issues/139/labels{/name}","comments_url":"https://api.github.com/repos/ipfs/pm/issues/139/comments","events_url":"https://api.github.com/repos/ipfs/pm/issues/139/events","html_url":"https://github.com/ipfs/pm/issues/139","id":170297988,"number":139,"title":"Better documenting the calls","user":{"login":"nicola","id":1424850,"avatar_url":"https://avatars.githubusercontent.com/u/1424850?v=3","gravatar_id":"","url":"https://api.github.com/users/nicola","html_url":"https://github.com/nicola","followers_url":"https://api.github.com/users/nicola/followers","following_url":"https://api.github.com/users/nicola/following{/other_user}","gists_url":"https://api.github.com/users/nicola/gists{/gist_id}","starred_url":"https://api.github.com/users/nicola/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nicola/subscriptions","organizations_url":"https://api.github.com/users/nicola/orgs","repos_url":"https://api.github.com/users/nicola/repos","events_url":"https://api.github.com/users/nicola/events{/privacy}","received_events_url":"https://api.github.com/users/nicola/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":7,"created_at":"2016-08-09T23:51:48Z","updated_at":"2016-08-11T14:18:49Z","closed_at":null,"body":"#### General problem\r\nIn our calls beyond the important discussions (that need to be written down), we often have a list of todos (that many will want to see). We often do wrap-ups, we post notes in different repos & so on.\r\n\r\n#### Problems in the 8th Aug call\r\nWe took notes but we post them in different places:\r\n- IPLD notes: https://github.com/ipfs/pm/issues/124#issuecomment-238724365\r\n- all-hands notes: https://github.com/ipfs/pm/issues/133#issuecomment-238384282\r\n- pubsub notes: https://github.com/libp2p/pubsub/issues/1\r\n\r\nProblems:\r\n- It is very difficult for new comers to find out what happened\r\n- It is difficult for us to go back and have a read about what happened, and search to past notes\r\n- It is difficult for us to understand what are the action points of the different sessions\r\n\r\n#### Possible solutions\r\n- **ONE REPO**: Have one repo for notes from every call, say `/ipfs/calls` and in there we create an issue every single time we have a call (/ipfs/pm has too much going on for proposing calls, and other pm stuff)\r\n- **IN THE SPRINT ISSUE**: Every sprint issue has links to the notes, or the notes are new issues in different repos that link back to the sprint (so one can go and have a look at the sprint links to find out)\r\n\r\n--\r\n\r\nMaybe there are other solutions I haven't considered, I think having the repo using issues as notes, or even committing notes as files, can really be a great solution to this problem.\r\n\r\n--- \r\n\r\ncc @RichardLitt, @diasdavid, @flyingzumwalt, @em-ly, @jbenet "},"comment":{"url":"https://api.github.com/repos/ipfs/pm/issues/comments/239174561","html_url":"https://github.com/ipfs/pm/issues/139#issuecomment-239174561","issue_url":"https://api.github.com/repos/ipfs/pm/issues/139","id":239174561,"user":{"login":"RichardLitt","id":910753,"avatar_url":"https://avatars.githubusercontent.com/u/910753?v=3","gravatar_id":"","url":"https://api.github.com/users/RichardLitt","html_url":"https://github.com/RichardLitt","followers_url":"https://api.github.com/users/RichardLitt/followers","following_url":"https://api.github.com/users/RichardLitt/following{/other_user}","gists_url":"https://api.github.com/users/RichardLitt/gists{/gist_id}","starred_url":"https://api.github.com/users/RichardLitt/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/RichardLitt/subscriptions","organizations_url":"https://api.github.com/users/RichardLitt/orgs","repos_url":"https://api.github.com/users/RichardLitt/repos","events_url":"https://api.github.com/users/RichardLitt/events{/privacy}","received_events_url":"https://api.github.com/users/RichardLitt/received_events","type":"User","site_admin":false},"created_at":"2016-08-11T14:18:49Z","updated_at":"2016-08-11T14:18:49Z","body":"Since the README is currently in a state of revision, I am going to keep this open to remind myself to do this every week. "}}
{"actor":{"display_login":"RichardLitt"}}