{"action":"created","issue":{"url":"https://api.github.com/repos/mbruzek/docs/issues/15","labels_url":"https://api.github.com/repos/mbruzek/docs/issues/15/labels{/name}","comments_url":"https://api.github.com/repos/mbruzek/docs/issues/15/comments","events_url":"https://api.github.com/repos/mbruzek/docs/issues/15/events","html_url":"https://github.com/mbruzek/docs/issues/15","id":117628193,"number":15,"title":"replace reference-hook-tools with developer-hook-tools","user":{"login":"mbruzek","id":6385185,"avatar_url":"https://avatars.githubusercontent.com/u/6385185?v=3","gravatar_id":"","url":"https://api.github.com/users/mbruzek","html_url":"https://github.com/mbruzek","followers_url":"https://api.github.com/users/mbruzek/followers","following_url":"https://api.github.com/users/mbruzek/following{/other_user}","gists_url":"https://api.github.com/users/mbruzek/gists{/gist_id}","starred_url":"https://api.github.com/users/mbruzek/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mbruzek/subscriptions","organizations_url":"https://api.github.com/users/mbruzek/orgs","repos_url":"https://api.github.com/users/mbruzek/repos","events_url":"https://api.github.com/users/mbruzek/events{/privacy}","received_events_url":"https://api.github.com/users/mbruzek/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-11-18T16:45:09Z","updated_at":"2015-11-18T17:17:32Z","closed_at":null,"body":"These documents are very similar and the developer-hook-tools is more correct, and up to date."},"comment":{"url":"https://api.github.com/repos/mbruzek/docs/issues/comments/157784078","html_url":"https://github.com/mbruzek/docs/issues/15#issuecomment-157784078","issue_url":"https://api.github.com/repos/mbruzek/docs/issues/15","id":157784078,"user":{"login":"evilnick","id":115290,"avatar_url":"https://avatars.githubusercontent.com/u/115290?v=3","gravatar_id":"","url":"https://api.github.com/users/evilnick","html_url":"https://github.com/evilnick","followers_url":"https://api.github.com/users/evilnick/followers","following_url":"https://api.github.com/users/evilnick/following{/other_user}","gists_url":"https://api.github.com/users/evilnick/gists{/gist_id}","starred_url":"https://api.github.com/users/evilnick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/evilnick/subscriptions","organizations_url":"https://api.github.com/users/evilnick/orgs","repos_url":"https://api.github.com/users/evilnick/repos","events_url":"https://api.github.com/users/evilnick/events{/privacy}","received_events_url":"https://api.github.com/users/evilnick/received_events","type":"User","site_admin":false},"created_at":"2015-11-18T17:17:32Z","updated_at":"2015-11-18T17:17:32Z","body":"yeah, I completely disagree. \r\n\r\n1) the hooks tools are a REFERENCE document, and should be in the reference section\r\n2) although I guess you would want to update the examples (why can't we have bash and charmhelpers?), the explanations and caveats given in the reference version of the doc are actually more comprehensive in the majority of cases:\r\ne.g. compare:\r\n\r\n---\r\nopened-ports\r\n\r\nopened-ports lists all ports or ranges opened by the unit.\r\n\r\nfrom subprocess import check_output\r\n\r\nrange = check_output([\"opened-ports\"])\r\nopened-ports\r\nopened-ports.exe\r\n\r\n---\r\n\r\nwith:\r\n\r\nopened-ports\r\n\r\nThe opened-ports hook tool lists all the ports currently opened by the running charm. It does not, at the moment, include ports which may be opened by other charms co-hosted on the same machine lp #1427770.\r\n\r\nThe command returns a list of one port or range of ports per line, with the port number followed by the protocol (tcp or udp).\r\n\r\nFor example, running opened-ports may return:\r\n\r\n70-80/tcp\r\n81/tcp\r\n!!! Note: opening ports is transactional (i.e. will take place on successfully exiting the current hook), and therefore opened-ports will not return any values for pending open-port operations run from within the same hook.\r\n"}}