{"action":"created","issue":{"url":"https://api.github.com/repos/mapbox/rasterio/issues/608","repository_url":"https://api.github.com/repos/mapbox/rasterio","labels_url":"https://api.github.com/repos/mapbox/rasterio/issues/608/labels{/name}","comments_url":"https://api.github.com/repos/mapbox/rasterio/issues/608/comments","events_url":"https://api.github.com/repos/mapbox/rasterio/issues/608/events","html_url":"https://github.com/mapbox/rasterio/pull/608","id":144153659,"number":608,"title":"Added an example to docs on using a shapefile to mask a raster.","user":{"login":"jdmcbr","id":666108,"avatar_url":"https://avatars.githubusercontent.com/u/666108?v=3","gravatar_id":"","url":"https://api.github.com/users/jdmcbr","html_url":"https://github.com/jdmcbr","followers_url":"https://api.github.com/users/jdmcbr/followers","following_url":"https://api.github.com/users/jdmcbr/following{/other_user}","gists_url":"https://api.github.com/users/jdmcbr/gists{/gist_id}","starred_url":"https://api.github.com/users/jdmcbr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jdmcbr/subscriptions","organizations_url":"https://api.github.com/users/jdmcbr/orgs","repos_url":"https://api.github.com/users/jdmcbr/repos","events_url":"https://api.github.com/users/jdmcbr/events{/privacy}","received_events_url":"https://api.github.com/users/jdmcbr/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-03-29T04:33:40Z","updated_at":"2016-03-30T05:33:21Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/mapbox/rasterio/pulls/608","html_url":"https://github.com/mapbox/rasterio/pull/608","diff_url":"https://github.com/mapbox/rasterio/pull/608.diff","patch_url":"https://github.com/mapbox/rasterio/pull/608.patch"},"body":"This includes the very simple shapefile used to do the masking. I suspect though that including a shapefile in the repository is undesirable. If so, I can try to find something smallish and freely available to use online as an example.\r\n\r\nI kept exposition about the example to a minimum to start, in part because I wasn't sure if it would be better to use another data source for the example. For next steps, I think it would be useful to show the image at the start and after masking, as well as possibly showing a little more of the before/after metadata (in line with #593, though I guess the `fiona` dependency here might also be a problem for that). "},"comment":{"url":"https://api.github.com/repos/mapbox/rasterio/issues/comments/203255890","html_url":"https://github.com/mapbox/rasterio/pull/608#issuecomment-203255890","issue_url":"https://api.github.com/repos/mapbox/rasterio/issues/608","id":203255890,"user":{"login":"jdmcbr","id":666108,"avatar_url":"https://avatars.githubusercontent.com/u/666108?v=3","gravatar_id":"","url":"https://api.github.com/users/jdmcbr","html_url":"https://github.com/jdmcbr","followers_url":"https://api.github.com/users/jdmcbr/followers","following_url":"https://api.github.com/users/jdmcbr/following{/other_user}","gists_url":"https://api.github.com/users/jdmcbr/gists{/gist_id}","starred_url":"https://api.github.com/users/jdmcbr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jdmcbr/subscriptions","organizations_url":"https://api.github.com/users/jdmcbr/orgs","repos_url":"https://api.github.com/users/jdmcbr/repos","events_url":"https://api.github.com/users/jdmcbr/events{/privacy}","received_events_url":"https://api.github.com/users/jdmcbr/received_events","type":"User","site_admin":false},"created_at":"2016-03-30T05:33:21Z","updated_at":"2016-03-30T05:33:21Z","body":"Great, I'll add a couple of example images tomorrow."}}