{"action":"created","issue":{"url":"https://api.github.com/repos/graphite-project/carbon/issues/362","labels_url":"https://api.github.com/repos/graphite-project/carbon/issues/362/labels{/name}","comments_url":"https://api.github.com/repos/graphite-project/carbon/issues/362/comments","events_url":"https://api.github.com/repos/graphite-project/carbon/issues/362/events","html_url":"https://github.com/graphite-project/carbon/issues/362","id":54393095,"number":362,"title":"Drop \".example\" extension on sample (mandatory) conf files","user":{"login":"ryan-williams","id":465045,"avatar_url":"https://avatars.githubusercontent.com/u/465045?v=3","gravatar_id":"","url":"https://api.github.com/users/ryan-williams","html_url":"https://github.com/ryan-williams","followers_url":"https://api.github.com/users/ryan-williams/followers","following_url":"https://api.github.com/users/ryan-williams/following{/other_user}","gists_url":"https://api.github.com/users/ryan-williams/gists{/gist_id}","starred_url":"https://api.github.com/users/ryan-williams/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ryan-williams/subscriptions","organizations_url":"https://api.github.com/users/ryan-williams/orgs","repos_url":"https://api.github.com/users/ryan-williams/repos","events_url":"https://api.github.com/users/ryan-williams/events{/privacy}","received_events_url":"https://api.github.com/users/ryan-williams/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-01-14T23:35:39Z","updated_at":"2015-01-15T00:19:28Z","closed_at":"2015-01-14T23:43:54Z","body":"One confusing thing when trying to quick-start a graphite instance was having to strip the `.example` suffixes from `carbon.conf`, `storage-aggregation.conf`, and `storage-schemas.conf`.\r\n\r\nIf their contents provide workable defaults out of the box, then this is an unnecessary hurdle to put in the way of new users.\r\n\r\nLeaving them in `conf/` next to other `.example` files will sufficiently get the message across to users that they can/should be modified.\r\n\r\nAs it is, it is pretty overwhelming to see [9 `.conf.example` files in the repo](https://github.com/graphite-project/carbon/tree/master/conf) (15 in my `/opt/graphite/conf` after installing all graphite modules) and not know which ones are necessary vs. optional for certain installations."},"comment":{"url":"https://api.github.com/repos/graphite-project/carbon/issues/comments/70019225","html_url":"https://github.com/graphite-project/carbon/issues/362#issuecomment-70019225","issue_url":"https://api.github.com/repos/graphite-project/carbon/issues/362","id":70019225,"user":{"login":"obfuscurity","id":494338,"avatar_url":"https://avatars.githubusercontent.com/u/494338?v=3","gravatar_id":"","url":"https://api.github.com/users/obfuscurity","html_url":"https://github.com/obfuscurity","followers_url":"https://api.github.com/users/obfuscurity/followers","following_url":"https://api.github.com/users/obfuscurity/following{/other_user}","gists_url":"https://api.github.com/users/obfuscurity/gists{/gist_id}","starred_url":"https://api.github.com/users/obfuscurity/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/obfuscurity/subscriptions","organizations_url":"https://api.github.com/users/obfuscurity/orgs","repos_url":"https://api.github.com/users/obfuscurity/repos","events_url":"https://api.github.com/users/obfuscurity/events{/privacy}","received_events_url":"https://api.github.com/users/obfuscurity/received_events","type":"User","site_admin":false},"created_at":"2015-01-15T00:19:28Z","updated_at":"2015-01-15T00:19:28Z","body":"@ryan-williams I empathize but there's probably a better solution than what you proposed. Synthesize, for example, is highly opinionated and designed to \"just work\" on start. I look at that as \"training wheels\" for Graphite.\r\n\r\nNot to mention, your change would break all production setups on upgrade."}}