{"action":"created","issue":{"url":"https://api.github.com/repos/graphite-project/carbon/issues/347","labels_url":"https://api.github.com/repos/graphite-project/carbon/issues/347/labels{/name}","comments_url":"https://api.github.com/repos/graphite-project/carbon/issues/347/comments","events_url":"https://api.github.com/repos/graphite-project/carbon/issues/347/events","html_url":"https://github.com/graphite-project/carbon/issues/347","id":53314564,"number":347,"title":"Make README more quickstart-friendly","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":3,"created_at":"2015-01-03T20:31:21Z","updated_at":"2015-01-03T21:09:04Z","closed_at":"2015-01-03T20:36:37Z","body":"* afaict the preferred command for running a carbon server is `bin/carbon-cache.py start`, but this is not documented in the README anywhere.\r\n* the README makes assertions about paths under `$GRAPHITE_ROOT` but offers no explanation as to how someone should set `$GRAPHITE_ROOT`\r\n    * some info on the readthedocs.org and/or wikidot imply that this should always be `/opt/graphite`, yet the assumption seems to be that a full clone of this repository will live there\r\n    * is the assumption that this repository will be cloned to `/opt/graphite`?\r\n* the closest thing to a link to more info on the README is its opening link to the [graphite-project](https://github.com/graphite-project) page; the only relevant-seeming thing there is the [github pages](https://github.com/graphite-project/graphite-project.github.io) repo, which points to [http://graphite-project.github.io/](http://graphite-project.github.io/), which serves up an nginx 404; no information anywhere indicates whether this is intentional / known / scheduled to be fixed or whether that github pages repo should be considered defunct.. \r\n* if the readthedocs page is or will soon be the canonical source for graphite documentation, can we link to it more clearly? graphite-web does but carbon and whisper do not."},"comment":{"url":"https://api.github.com/repos/graphite-project/carbon/issues/comments/68609648","html_url":"https://github.com/graphite-project/carbon/issues/347#issuecomment-68609648","issue_url":"https://api.github.com/repos/graphite-project/carbon/issues/347","id":68609648,"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-03T21:09:03Z","updated_at":"2015-01-03T21:09:03Z","body":"Once the new website is up, that will be the canonical destination for Graphite users/visitors. It will have the necessary links to the documentation, or built-in content where applicable."}}