{"action":"created","issue":{"url":"https://api.github.com/repos/varnish/hitch/issues/41","labels_url":"https://api.github.com/repos/varnish/hitch/issues/41/labels{/name}","comments_url":"https://api.github.com/repos/varnish/hitch/issues/41/comments","events_url":"https://api.github.com/repos/varnish/hitch/issues/41/events","html_url":"https://github.com/varnish/hitch/issues/41","id":104658204,"number":41,"title":"Wish/suggestion: EXAMPLE section in man file to generate snakeoil cert","user":{"login":"KristianLyng","id":164636,"avatar_url":"https://avatars.githubusercontent.com/u/164636?v=3","gravatar_id":"","url":"https://api.github.com/users/KristianLyng","html_url":"https://github.com/KristianLyng","followers_url":"https://api.github.com/users/KristianLyng/followers","following_url":"https://api.github.com/users/KristianLyng/following{/other_user}","gists_url":"https://api.github.com/users/KristianLyng/gists{/gist_id}","starred_url":"https://api.github.com/users/KristianLyng/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/KristianLyng/subscriptions","organizations_url":"https://api.github.com/users/KristianLyng/orgs","repos_url":"https://api.github.com/users/KristianLyng/repos","events_url":"https://api.github.com/users/KristianLyng/events{/privacy}","received_events_url":"https://api.github.com/users/KristianLyng/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-09-03T09:49:38Z","updated_at":"2015-09-03T11:57:35Z","closed_at":null,"body":"It took me quite a while to figure out the format for the certificate, and as you can see here http://ingvar.blog.redpill-linpro.com/2015/06/26/hitch-1-0-0-beta3-for-fedora-and-epel/ , Ingvar suggests just downloading something he made. This seems to apply to any project involving ssl/tls certificates, but the last step required for the certificates was a bit unexpected to me.\r\n\r\nObviously for production you need a proper certificate and whatnot, but particularly now when Hitch is young, I think it's important to make it easy for people to test.\r\n\r\nSuggestion: Move parts of https://github.com/varnish/hitch/blob/master/src/tests/certs/README to a more discoverable place. I suggest an EXAMPLES section in the man file. (Possibly add non-Debian specific variant, until the rest of the world catches up to the brilliance of Debian)."},"comment":{"url":"https://api.github.com/repos/varnish/hitch/issues/comments/137416699","html_url":"https://github.com/varnish/hitch/issues/41#issuecomment-137416699","issue_url":"https://api.github.com/repos/varnish/hitch/issues/41","id":137416699,"user":{"login":"KristianLyng","id":164636,"avatar_url":"https://avatars.githubusercontent.com/u/164636?v=3","gravatar_id":"","url":"https://api.github.com/users/KristianLyng","html_url":"https://github.com/KristianLyng","followers_url":"https://api.github.com/users/KristianLyng/followers","following_url":"https://api.github.com/users/KristianLyng/following{/other_user}","gists_url":"https://api.github.com/users/KristianLyng/gists{/gist_id}","starred_url":"https://api.github.com/users/KristianLyng/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/KristianLyng/subscriptions","organizations_url":"https://api.github.com/users/KristianLyng/orgs","repos_url":"https://api.github.com/users/KristianLyng/repos","events_url":"https://api.github.com/users/KristianLyng/events{/privacy}","received_events_url":"https://api.github.com/users/KristianLyng/received_events","type":"User","site_admin":false},"created_at":"2015-09-03T11:57:35Z","updated_at":"2015-09-03T11:57:35Z","body":"Not necessary, but then the issue is: doc/certificates.md is not distributed in the tar-ball :)\r\n\r\nI would still suggest at least something in EXAMPLES or  reference to that file in the man file, if there was a doc/ in the tar-ball, I would've read that of course."}}