{"action":"created","issue":{"url":"https://api.github.com/repos/openaddresses/openaddresses-ops/issues/7","labels_url":"https://api.github.com/repos/openaddresses/openaddresses-ops/issues/7/labels{/name}","comments_url":"https://api.github.com/repos/openaddresses/openaddresses-ops/issues/7/comments","events_url":"https://api.github.com/repos/openaddresses/openaddresses-ops/issues/7/events","html_url":"https://github.com/openaddresses/openaddresses-ops/issues/7","id":107352767,"number":7,"title":"Proposal: expand supported license data","user":{"login":"migurski","id":58730,"avatar_url":"https://avatars.githubusercontent.com/u/58730?v=3","gravatar_id":"","url":"https://api.github.com/users/migurski","html_url":"https://github.com/migurski","followers_url":"https://api.github.com/users/migurski/followers","following_url":"https://api.github.com/users/migurski/following{/other_user}","gists_url":"https://api.github.com/users/migurski/gists{/gist_id}","starred_url":"https://api.github.com/users/migurski/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/migurski/subscriptions","organizations_url":"https://api.github.com/users/migurski/orgs","repos_url":"https://api.github.com/users/migurski/repos","events_url":"https://api.github.com/users/migurski/events{/privacy}","received_events_url":"https://api.github.com/users/migurski/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/openaddresses/openaddresses-ops/labels/enhancement","name":"enhancement","color":"84b6eb"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":22,"created_at":"2015-09-19T19:55:21Z","updated_at":"2015-11-08T02:04:04Z","closed_at":null,"body":"Based on the [license principles discussion](https://github.com/openaddresses/openaddresses-ops/issues/3), I’d like to recommend a formal change to [the contribution guidelines](https://github.com/openaddresses/openaddresses/blob/master/CONTRIBUTING.md) and our parsing code to support an optional extended description.\r\n\r\nCurrently, the license [is documented as “a URL or string”](https://github.com/openaddresses/openaddresses/blob/master/CONTRIBUTING.md#optional-tags), and supports both explicit links and implicit short strings:\r\n\r\n    \"license\": \"http://geonb.snb.ca/downloads/documents/geonb_license_e.pdf\"\r\n\r\nAlso valid:\r\n\r\n    \"license\": \"CC-BY-SA\"\r\n\r\nWe should support an additional expanded version of the license data, with true/false flags for license properties such as required attribution or share-alike:\r\n\r\n    \"license\": {\r\n        \"url\": \"http://geonb.snb.ca/downloads/documents/geonb_license_e.pdf\",\r\n        \"attribution-string\": \"GeoNB – www.snb.ca/geonb\",\r\n        \"attribution\": true,\r\n        \"share-alike\": false\r\n    }\r\n\r\nThe old forms will still be acceptable. In cases where attribution or share-alike are not explicitly defined, we would assume both are required.\r\n\r\nIf this proposal were accepted, here are the next steps:\r\n\r\n1. Write and test machine code to support the structure above.\r\n2. Deploy new machine code.\r\n3. Update contribution guide to reflect newly-supported structure.\r\n4. Research licenses of existing sources to determine their properties.\r\n5. Expand existing sources to use new license structure.\r\n6. Determine whether to deprecate older URL/string structure."},"comment":{"url":"https://api.github.com/repos/openaddresses/openaddresses-ops/issues/comments/154770435","html_url":"https://github.com/openaddresses/openaddresses-ops/issues/7#issuecomment-154770435","issue_url":"https://api.github.com/repos/openaddresses/openaddresses-ops/issues/7","id":154770435,"user":{"login":"migurski","id":58730,"avatar_url":"https://avatars.githubusercontent.com/u/58730?v=3","gravatar_id":"","url":"https://api.github.com/users/migurski","html_url":"https://github.com/migurski","followers_url":"https://api.github.com/users/migurski/followers","following_url":"https://api.github.com/users/migurski/following{/other_user}","gists_url":"https://api.github.com/users/migurski/gists{/gist_id}","starred_url":"https://api.github.com/users/migurski/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/migurski/subscriptions","organizations_url":"https://api.github.com/users/migurski/orgs","repos_url":"https://api.github.com/users/migurski/repos","events_url":"https://api.github.com/users/migurski/events{/privacy}","received_events_url":"https://api.github.com/users/migurski/received_events","type":"User","site_admin":false},"created_at":"2015-11-08T02:04:04Z","updated_at":"2015-11-08T02:04:04Z","body":"Comments from @NelsonMinar suggest that splitting attribution downloads doesn’t make sense, but that splitting share-alike ones does. I’m going to put https://github.com/openaddresses/machine/issues/236 and https://github.com/openaddresses/machine/pull/248 on ice for a little while, and introduce a share-alike flag first."}}