{"action":"created","issue":{"url":"https://api.github.com/repos/apidoc/apidoc/issues/310","repository_url":"https://api.github.com/repos/apidoc/apidoc","labels_url":"https://api.github.com/repos/apidoc/apidoc/issues/310/labels{/name}","comments_url":"https://api.github.com/repos/apidoc/apidoc/issues/310/comments","events_url":"https://api.github.com/repos/apidoc/apidoc/issues/310/events","html_url":"https://github.com/apidoc/apidoc/issues/310","id":98066465,"number":310,"title":"Multiple @apiUses render in the wrong order","user":{"login":"davestewart","id":132681,"avatar_url":"https://avatars.githubusercontent.com/u/132681?v=3","gravatar_id":"","url":"https://api.github.com/users/davestewart","html_url":"https://github.com/davestewart","followers_url":"https://api.github.com/users/davestewart/followers","following_url":"https://api.github.com/users/davestewart/following{/other_user}","gists_url":"https://api.github.com/users/davestewart/gists{/gist_id}","starred_url":"https://api.github.com/users/davestewart/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davestewart/subscriptions","organizations_url":"https://api.github.com/users/davestewart/orgs","repos_url":"https://api.github.com/users/davestewart/repos","events_url":"https://api.github.com/users/davestewart/events{/privacy}","received_events_url":"https://api.github.com/users/davestewart/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/apidoc/apidoc/labels/todo","name":"todo","color":"009800"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-07-30T01:43:02Z","updated_at":"2016-04-12T20:12:19Z","closed_at":null,"body":"Using multiple @apiUse tags appear to render in the wrong order.\r\n\r\nConsider the following code:\r\n\r\n\t/**\r\n\t * @apiDefine Status\r\n\t * @apiSuccess {Number}\t\tstatus\t\t\tThe HTTP status of the call\r\n\t * @apiSuccess {String}\t\tmessage\t\t\tA human-friendly summary of the result of the call\r\n\t */\r\n\r\n\t/**\r\n\t * @apiDefine Success\r\n\t * @apiSuccess {Number}\t\tdata.id\t\t\tThe user's id\r\n\t * @apiSuccess {String}\t\tdata.firstName\tThe user's first name\r\n\t * @apiSuccess {String}\t\tdata.lastName\tThe user's last name\r\n\t */\r\n\r\n\t/**\r\n\t * @api {get}\t\t\t\t/users\t\t\tRequest all users\r\n\t * @apiGroup user\r\n\t * @apiName all\r\n\t *\r\n\t * @apiParam {Number}\t\tid\t\t\t\tThe id of the requested user\r\n\t * @apiParam {String}\t\tname\t\t\tThe user's name\r\n\t *\r\n\t * @apiUse Status\r\n\t * @apiSuccess {Object[]}\tdata\t\t\tAn array of users\r\n\t * @apiUse Success\r\n\t */\r\n\t$app->get('/users', '\\\\controllers\\\\UserController:all');\r\n\r\nIn the last section of the last DocBlock, I'm hoping to render:\r\n\r\n - The default API status output\r\n - A custom {Object[]} param\r\n - The default output for all users in this REST group\r\n\r\nHowever, The actual output order is:\r\n\r\n - A custom {Object[]} param\r\n - The default API status output\r\n - The default output for all users in this REST group\r\n\r\nThe result is as follows:\r\n\r\n![api-doc-api-use-issue](https://cloud.githubusercontent.com/assets/132681/8974040/f54aaa8e-3664-11e5-91de-38c6c2406340.png)\r\n"},"comment":{"url":"https://api.github.com/repos/apidoc/apidoc/issues/comments/209084286","html_url":"https://github.com/apidoc/apidoc/issues/310#issuecomment-209084286","issue_url":"https://api.github.com/repos/apidoc/apidoc/issues/310","id":209084286,"user":{"login":"mauler","id":234982,"avatar_url":"https://avatars.githubusercontent.com/u/234982?v=3","gravatar_id":"","url":"https://api.github.com/users/mauler","html_url":"https://github.com/mauler","followers_url":"https://api.github.com/users/mauler/followers","following_url":"https://api.github.com/users/mauler/following{/other_user}","gists_url":"https://api.github.com/users/mauler/gists{/gist_id}","starred_url":"https://api.github.com/users/mauler/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mauler/subscriptions","organizations_url":"https://api.github.com/users/mauler/orgs","repos_url":"https://api.github.com/users/mauler/repos","events_url":"https://api.github.com/users/mauler/events{/privacy}","received_events_url":"https://api.github.com/users/mauler/received_events","type":"User","site_admin":false},"created_at":"2016-04-12T20:12:19Z","updated_at":"2016-04-12T20:12:19Z","body":"https://github.com/apidoc/apidoc/pull/457"}}