{"action":"created","issue":{"url":"https://api.github.com/repos/zeromq/libzmq/issues/1876","repository_url":"https://api.github.com/repos/zeromq/libzmq","labels_url":"https://api.github.com/repos/zeromq/libzmq/issues/1876/labels{/name}","comments_url":"https://api.github.com/repos/zeromq/libzmq/issues/1876/comments","events_url":"https://api.github.com/repos/zeromq/libzmq/issues/1876/events","html_url":"https://github.com/zeromq/libzmq/issues/1876","id":144598460,"number":1876,"title":"Problem: API has mix of draft and stable","user":{"login":"hintjens","id":307976,"avatar_url":"https://avatars.githubusercontent.com/u/307976?v=3","gravatar_id":"","url":"https://api.github.com/users/hintjens","html_url":"https://github.com/hintjens","followers_url":"https://api.github.com/users/hintjens/followers","following_url":"https://api.github.com/users/hintjens/following{/other_user}","gists_url":"https://api.github.com/users/hintjens/gists{/gist_id}","starred_url":"https://api.github.com/users/hintjens/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/hintjens/subscriptions","organizations_url":"https://api.github.com/users/hintjens/orgs","repos_url":"https://api.github.com/users/hintjens/repos","events_url":"https://api.github.com/users/hintjens/events{/privacy}","received_events_url":"https://api.github.com/users/hintjens/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-03-30T13:46:23Z","updated_at":"2016-03-30T14:34:50Z","closed_at":null,"body":"We would like to ship a 4.2 stable that includes draft APIs, e.g. client/server/radio/dish.\r\n\r\nSolution: this is a sketch of several pieces taken from zproject. This issue is for discussion.\r\n\r\n* break zmq.h, internally, into classes and mark each as draft/stable using tags in comments\r\n* add documentation for each method directly into zmq.h, as alternative to hand-written man pages (we can generate selectively)\r\n* adapt zproject's `mkman` tool for this.\r\n* consider sample/test code that can be included in each man page (like zproject)\r\n"},"comment":{"url":"https://api.github.com/repos/zeromq/libzmq/issues/comments/203460968","html_url":"https://github.com/zeromq/libzmq/issues/1876#issuecomment-203460968","issue_url":"https://api.github.com/repos/zeromq/libzmq/issues/1876","id":203460968,"user":{"login":"somdoron","id":2715638,"avatar_url":"https://avatars.githubusercontent.com/u/2715638?v=3","gravatar_id":"","url":"https://api.github.com/users/somdoron","html_url":"https://github.com/somdoron","followers_url":"https://api.github.com/users/somdoron/followers","following_url":"https://api.github.com/users/somdoron/following{/other_user}","gists_url":"https://api.github.com/users/somdoron/gists{/gist_id}","starred_url":"https://api.github.com/users/somdoron/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/somdoron/subscriptions","organizations_url":"https://api.github.com/users/somdoron/orgs","repos_url":"https://api.github.com/users/somdoron/repos","events_url":"https://api.github.com/users/somdoron/events{/privacy}","received_events_url":"https://api.github.com/users/somdoron/received_events","type":"User","site_admin":false},"created_at":"2016-03-30T14:34:50Z","updated_at":"2016-03-30T14:34:50Z","body":"I like the splitting the file suggestion.\r\n\r\nIt might be not related but I would like to see the zmq API replaced by the CZMQ API one day. It least for zsock, zframe and zmsg API.\r\n\r\n\r\n"}}