{"action":"created","issue":{"url":"https://api.github.com/repos/amethyst/amethyst/issues/29","repository_url":"https://api.github.com/repos/amethyst/amethyst","labels_url":"https://api.github.com/repos/amethyst/amethyst/issues/29/labels{/name}","comments_url":"https://api.github.com/repos/amethyst/amethyst/issues/29/comments","events_url":"https://api.github.com/repos/amethyst/amethyst/issues/29/events","html_url":"https://github.com/amethyst/amethyst/issues/29","id":143117383,"number":29,"title":"RFC: Config.yml Specification","user":{"login":"White-Oak","id":2813216,"avatar_url":"https://avatars.githubusercontent.com/u/2813216?v=3","gravatar_id":"","url":"https://api.github.com/users/White-Oak","html_url":"https://github.com/White-Oak","followers_url":"https://api.github.com/users/White-Oak/followers","following_url":"https://api.github.com/users/White-Oak/following{/other_user}","gists_url":"https://api.github.com/users/White-Oak/gists{/gist_id}","starred_url":"https://api.github.com/users/White-Oak/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/White-Oak/subscriptions","organizations_url":"https://api.github.com/users/White-Oak/orgs","repos_url":"https://api.github.com/users/White-Oak/repos","events_url":"https://api.github.com/users/White-Oak/events{/privacy}","received_events_url":"https://api.github.com/users/White-Oak/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/amethyst/amethyst/labels/diff:%20medium","name":"diff: medium","color":"fef2c0"},{"url":"https://api.github.com/repos/amethyst/amethyst/labels/pri:%20important","name":"pri: important","color":"f7c6c7"},{"url":"https://api.github.com/repos/amethyst/amethyst/labels/type:%20RFC","name":"type: RFC","color":"84b6eb"}],"state":"open","locked":false,"assignee":{"login":"White-Oak","id":2813216,"avatar_url":"https://avatars.githubusercontent.com/u/2813216?v=3","gravatar_id":"","url":"https://api.github.com/users/White-Oak","html_url":"https://github.com/White-Oak","followers_url":"https://api.github.com/users/White-Oak/followers","following_url":"https://api.github.com/users/White-Oak/following{/other_user}","gists_url":"https://api.github.com/users/White-Oak/gists{/gist_id}","starred_url":"https://api.github.com/users/White-Oak/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/White-Oak/subscriptions","organizations_url":"https://api.github.com/users/White-Oak/orgs","repos_url":"https://api.github.com/users/White-Oak/repos","events_url":"https://api.github.com/users/White-Oak/events{/privacy}","received_events_url":"https://api.github.com/users/White-Oak/received_events","type":"User","site_admin":false},"milestone":null,"comments":19,"created_at":"2016-03-24T00:57:49Z","updated_at":"2016-03-28T03:49:02Z","closed_at":null,"body":"Proposed specs:\r\n```\r\nYAML                             || values                                || default\r\n---\r\nlogging:\r\n    file_path: \"new_project.log\" || string;                               || \"log.log\"\r\n    output_level: warn           || [no, error, warn, info, debug, trace] || debug\r\n    logging_level: debug         || [no, error, warn, info, debug, trace] || debug\r\n\r\ndisplay:\r\n    brightness: 1.0              || 0.0 to 1.0                            || 1.0\r\n    fullscreen: false            || bool                                  || false\r\n    size: [1024, 768]            || array of two ints                     || [1024; 768]\r\ntitle: \"My coolest game\"         || string                                || \"Amethyst game\"\r\n```\r\n\r\n# Separate configs\r\nMain `config.yml` may not include certain configuration secions if they are being mantained separatedly, for example being mantained by a shard.\r\n\r\nIf a section of a config is missing like `display` in this example:\r\n```yaml\r\nlogging:\r\n    file_path: \"new_project.log\"\r\n    output_level: warn\r\n    logging_level: debug\r\ntitle: \"My coolest game\"\r\n```\r\nAmethyst will look for `display.yml` to evaluate missing properties.\r\n\r\nIf the file display.yaml does not exist, default properties are added to config.yaml.\r\nIf display.yaml exists, but properties are missing, missing properties are added to display.yaml.\r\n\r\n**Not clear if `<name>.yml` should contain a name of a section or not**\r\n`display.yml`:\r\n```yaml\r\ndisplay:\r\n    brightness: 1.0\r\n    fullscreen: false\r\n    size: [1024, 768]\r\n```\r\nversus\r\n```yaml\r\nbrightness: 1.0\r\nfullscreen: false\r\nsize: [1024, 768]\r\n```\r\n"},"comment":{"url":"https://api.github.com/repos/amethyst/amethyst/issues/comments/202220774","html_url":"https://github.com/amethyst/amethyst/issues/29#issuecomment-202220774","issue_url":"https://api.github.com/repos/amethyst/amethyst/issues/29","id":202220774,"user":{"login":"White-Oak","id":2813216,"avatar_url":"https://avatars.githubusercontent.com/u/2813216?v=3","gravatar_id":"","url":"https://api.github.com/users/White-Oak","html_url":"https://github.com/White-Oak","followers_url":"https://api.github.com/users/White-Oak/followers","following_url":"https://api.github.com/users/White-Oak/following{/other_user}","gists_url":"https://api.github.com/users/White-Oak/gists{/gist_id}","starred_url":"https://api.github.com/users/White-Oak/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/White-Oak/subscriptions","organizations_url":"https://api.github.com/users/White-Oak/orgs","repos_url":"https://api.github.com/users/White-Oak/repos","events_url":"https://api.github.com/users/White-Oak/events{/privacy}","received_events_url":"https://api.github.com/users/White-Oak/received_events","type":"User","site_admin":false},"created_at":"2016-03-28T03:49:02Z","updated_at":"2016-03-28T03:49:02Z","body":"@ebkalderon me too, but need other opinions."}}