{"action":"created","issue":{"url":"https://api.github.com/repos/phalcon/zephir/issues/724","labels_url":"https://api.github.com/repos/phalcon/zephir/issues/724/labels{/name}","comments_url":"https://api.github.com/repos/phalcon/zephir/issues/724/comments","events_url":"https://api.github.com/repos/phalcon/zephir/issues/724/events","html_url":"https://github.com/phalcon/zephir/pull/724","id":55376090,"number":724,"title":"Api documentation generation","user":{"login":"SneakyBobito","id":3215399,"avatar_url":"https://avatars.githubusercontent.com/u/3215399?v=3","gravatar_id":"","url":"https://api.github.com/users/SneakyBobito","html_url":"https://github.com/SneakyBobito","followers_url":"https://api.github.com/users/SneakyBobito/followers","following_url":"https://api.github.com/users/SneakyBobito/following{/other_user}","gists_url":"https://api.github.com/users/SneakyBobito/gists{/gist_id}","starred_url":"https://api.github.com/users/SneakyBobito/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SneakyBobito/subscriptions","organizations_url":"https://api.github.com/users/SneakyBobito/orgs","repos_url":"https://api.github.com/users/SneakyBobito/repos","events_url":"https://api.github.com/users/SneakyBobito/events{/privacy}","received_events_url":"https://api.github.com/users/SneakyBobito/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-01-24T16:19:50Z","updated_at":"2015-02-09T14:54:15Z","closed_at":"2015-02-09T14:54:08Z","pull_request":{"url":"https://api.github.com/repos/phalcon/zephir/pulls/724","html_url":"https://github.com/phalcon/zephir/pull/724","diff_url":"https://github.com/phalcon/zephir/pull/724.diff","patch_url":"https://github.com/phalcon/zephir/pull/724.patch"},"body":"This PR includes the implementation for the ``zephir api`` command.\r\n\r\n\r\nAPI generation\r\n============\r\n\r\nThe core of the generation is ready, though there is still a few work to do, we can already use it.\r\n\r\nThe api generation is not hard coded. Instead there is core generator, in whitch we can plug a theme (a bit like sphinx documentation works). Right now the theme path is relative to zephir path, it's already planned to make this path also relative to the project root.\r\n\r\nDefault Theme for api\r\n=================\r\n\r\nThe PR also includes a default theme for the api generation. The theme is not 100% ready, there is still a couple of htlm + css to do to finish it.\r\n\r\n\r\nDocblock parser\r\n=============\r\n\r\nThe PR also includes a docblock parser, that was needed to get the annotations.   The docblock parsed is not 100% ready, but it returns a valid Docblock object. The api should not change, we can already safely use it and rewrite the internal work of the parser latter.\r\n\r\n\r\nTests\r\n====\r\n\r\nRight now there is no test written, it's already planed to write them"},"comment":{"url":"https://api.github.com/repos/phalcon/zephir/issues/comments/73521122","html_url":"https://github.com/phalcon/zephir/pull/724#issuecomment-73521122","issue_url":"https://api.github.com/repos/phalcon/zephir/issues/724","id":73521122,"user":{"login":"phalcon","id":1221505,"avatar_url":"https://avatars.githubusercontent.com/u/1221505?v=3","gravatar_id":"","url":"https://api.github.com/users/phalcon","html_url":"https://github.com/phalcon","followers_url":"https://api.github.com/users/phalcon/followers","following_url":"https://api.github.com/users/phalcon/following{/other_user}","gists_url":"https://api.github.com/users/phalcon/gists{/gist_id}","starred_url":"https://api.github.com/users/phalcon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/phalcon/subscriptions","organizations_url":"https://api.github.com/users/phalcon/orgs","repos_url":"https://api.github.com/users/phalcon/repos","events_url":"https://api.github.com/users/phalcon/events{/privacy}","received_events_url":"https://api.github.com/users/phalcon/received_events","type":"User","site_admin":false},"created_at":"2015-02-09T14:54:15Z","updated_at":"2015-02-09T14:54:15Z","body":"Thanks!"}}