{"action":"created","issue":{"url":"https://api.github.com/repos/wxtiles/wxtiles-docs/issues/7","repository_url":"https://api.github.com/repos/wxtiles/wxtiles-docs","labels_url":"https://api.github.com/repos/wxtiles/wxtiles-docs/issues/7/labels{/name}","comments_url":"https://api.github.com/repos/wxtiles/wxtiles-docs/issues/7/comments","events_url":"https://api.github.com/repos/wxtiles/wxtiles-docs/issues/7/events","html_url":"https://github.com/wxtiles/wxtiles-docs/pull/7","id":174453054,"number":7,"title":"adds instance details information","user":{"login":"alpha-beta-soup","id":5925045,"avatar_url":"https://avatars.githubusercontent.com/u/5925045?v=3","gravatar_id":"","url":"https://api.github.com/users/alpha-beta-soup","html_url":"https://github.com/alpha-beta-soup","followers_url":"https://api.github.com/users/alpha-beta-soup/followers","following_url":"https://api.github.com/users/alpha-beta-soup/following{/other_user}","gists_url":"https://api.github.com/users/alpha-beta-soup/gists{/gist_id}","starred_url":"https://api.github.com/users/alpha-beta-soup/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alpha-beta-soup/subscriptions","organizations_url":"https://api.github.com/users/alpha-beta-soup/orgs","repos_url":"https://api.github.com/users/alpha-beta-soup/repos","events_url":"https://api.github.com/users/alpha-beta-soup/events{/privacy}","received_events_url":"https://api.github.com/users/alpha-beta-soup/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":3,"created_at":"2016-09-01T07:16:40Z","updated_at":"2016-09-06T05:28:23Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/wxtiles/wxtiles-docs/pulls/7","html_url":"https://github.com/wxtiles/wxtiles-docs/pull/7","diff_url":"https://github.com/wxtiles/wxtiles-docs/pull/7.diff","patch_url":"https://github.com/wxtiles/wxtiles-docs/pull/7.patch"},"body":"In the next release, there will be additional information available about instances, including a typology of instance types that should aid in interpretation of instances (`cyclic`, `observational`, and `model`). I've made an initial commit but I want to discuss how we explain the instance concepts to users, as it is an area of confusion for many.\r\n\r\nAlso I'm not sure how to express in the `swagger.yaml` that a property may be null. All of the new properties introduced here are nullable.\r\n\r\nAs an example of the end product, and instance entity in the wxtiles API will might shortly look like:\r\n\r\n```json\r\n{\r\n    \"end\": \"2015-09-29T12:00:00Z\",\r\n    \"name\": \"2015-09-22T12:00:00Z\",\r\n    \"created\": \"2016-09-01T06:00:13.958631Z\",\r\n    \"start\": \"2015-09-22T12:00:00Z\",\r\n    \"type\": \"cyclic\",\r\n    \"id\": \"20150922_12\",\r\n    \"description\": \"NCEP model run\"\r\n}\r\n```\r\n\r\nWhere once it was:\r\n\r\n```json\r\n{\r\n    \"start\": \"2016-08-31T00:00:00Z\",\r\n    \"end\": \"2016-08-31T03:00:00Z\",\r\n    \"id\": \"20160831_00\",\r\n    \"created\": \"2016-09-01T05:46:34.317571Z\"\r\n}\r\n```\r\n\r\nNote that `name` is often an ISO8601 datetime, but is not constrained to be, it should just be considered presentable text.\r\n\r\nAlso worth discussing is whether we want instance `type` and `description` to live within a layer, as they are the same for all instances of a layer."},"comment":{"url":"https://api.github.com/repos/wxtiles/wxtiles-docs/issues/comments/244853164","html_url":"https://github.com/wxtiles/wxtiles-docs/pull/7#issuecomment-244853164","issue_url":"https://api.github.com/repos/wxtiles/wxtiles-docs/issues/7","id":244853164,"user":{"login":"alpha-beta-soup","id":5925045,"avatar_url":"https://avatars.githubusercontent.com/u/5925045?v=3","gravatar_id":"","url":"https://api.github.com/users/alpha-beta-soup","html_url":"https://github.com/alpha-beta-soup","followers_url":"https://api.github.com/users/alpha-beta-soup/followers","following_url":"https://api.github.com/users/alpha-beta-soup/following{/other_user}","gists_url":"https://api.github.com/users/alpha-beta-soup/gists{/gist_id}","starred_url":"https://api.github.com/users/alpha-beta-soup/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alpha-beta-soup/subscriptions","organizations_url":"https://api.github.com/users/alpha-beta-soup/orgs","repos_url":"https://api.github.com/users/alpha-beta-soup/repos","events_url":"https://api.github.com/users/alpha-beta-soup/events{/privacy}","received_events_url":"https://api.github.com/users/alpha-beta-soup/received_events","type":"User","site_admin":false},"created_at":"2016-09-06T05:28:23Z","updated_at":"2016-09-06T05:28:23Z","body":"And `model` is no longer a valid `instanceType`"}}
{"actor":{"display_login":"alpha-beta-soup"}}