{"action":"created","issue":{"url":"https://api.github.com/repos/joomlatools/developer.joomlatools.com/issues/29","labels_url":"https://api.github.com/repos/joomlatools/developer.joomlatools.com/issues/29/labels{/name}","comments_url":"https://api.github.com/repos/joomlatools/developer.joomlatools.com/issues/29/comments","events_url":"https://api.github.com/repos/joomlatools/developer.joomlatools.com/issues/29/events","html_url":"https://github.com/joomlatools/developer.joomlatools.com/issues/29","id":104655050,"number":29,"title":"[developer] Create Gitbook Apiary Plugin and Update Style","user":{"login":"stevenrombauts","id":77368,"avatar_url":"https://avatars.githubusercontent.com/u/77368?v=3","gravatar_id":"","url":"https://api.github.com/users/stevenrombauts","html_url":"https://github.com/stevenrombauts","followers_url":"https://api.github.com/users/stevenrombauts/followers","following_url":"https://api.github.com/users/stevenrombauts/following{/other_user}","gists_url":"https://api.github.com/users/stevenrombauts/gists{/gist_id}","starred_url":"https://api.github.com/users/stevenrombauts/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stevenrombauts/subscriptions","organizations_url":"https://api.github.com/users/stevenrombauts/orgs","repos_url":"https://api.github.com/users/stevenrombauts/repos","events_url":"https://api.github.com/users/stevenrombauts/events{/privacy}","received_events_url":"https://api.github.com/users/stevenrombauts/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/joomlatools/developer.joomlatools.com/milestones/2","html_url":"https://github.com/joomlatools/developer.joomlatools.com/milestones/Current","labels_url":"https://api.github.com/repos/joomlatools/developer.joomlatools.com/milestones/2/labels","id":1288067,"number":2,"title":"Current","description":"","creator":{"login":"stevenrombauts","id":77368,"avatar_url":"https://avatars.githubusercontent.com/u/77368?v=3","gravatar_id":"","url":"https://api.github.com/users/stevenrombauts","html_url":"https://github.com/stevenrombauts","followers_url":"https://api.github.com/users/stevenrombauts/followers","following_url":"https://api.github.com/users/stevenrombauts/following{/other_user}","gists_url":"https://api.github.com/users/stevenrombauts/gists{/gist_id}","starred_url":"https://api.github.com/users/stevenrombauts/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stevenrombauts/subscriptions","organizations_url":"https://api.github.com/users/stevenrombauts/orgs","repos_url":"https://api.github.com/users/stevenrombauts/repos","events_url":"https://api.github.com/users/stevenrombauts/events{/privacy}","received_events_url":"https://api.github.com/users/stevenrombauts/received_events","type":"User","site_admin":false},"open_issues":33,"closed_issues":17,"state":"open","created_at":"2015-09-03T09:26:48Z","updated_at":"2015-09-03T09:29:29Z","due_on":"2015-06-26T00:00:00Z","closed_at":null},"comments":9,"created_at":"2015-09-03T09:27:58Z","updated_at":"2015-09-03T09:42:48Z","closed_at":null,"body":"Work has already progressed. This plugin pre-renders api docs and pushes the content to the page.content property in Gitbook. \n \n[done]\n* add a config variable that lets you list the docs you want to convert \n* fix the styling for the rendered pages. combination jquery plugin/css.\n[todo]\n* add template path to config variable and pass that to the parser \n* add package dependancies\n* clean up the styling even more. \n* we may want to consider forking the bootstrap-mixin and make some changes to suit our needs. \n"},"comment":{"url":"https://api.github.com/repos/joomlatools/developer.joomlatools.com/issues/comments/137392991","html_url":"https://github.com/joomlatools/developer.joomlatools.com/issues/29#issuecomment-137392991","issue_url":"https://api.github.com/repos/joomlatools/developer.joomlatools.com/issues/29","id":137392991,"user":{"login":"stevenrombauts","id":77368,"avatar_url":"https://avatars.githubusercontent.com/u/77368?v=3","gravatar_id":"","url":"https://api.github.com/users/stevenrombauts","html_url":"https://github.com/stevenrombauts","followers_url":"https://api.github.com/users/stevenrombauts/followers","following_url":"https://api.github.com/users/stevenrombauts/following{/other_user}","gists_url":"https://api.github.com/users/stevenrombauts/gists{/gist_id}","starred_url":"https://api.github.com/users/stevenrombauts/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stevenrombauts/subscriptions","organizations_url":"https://api.github.com/users/stevenrombauts/orgs","repos_url":"https://api.github.com/users/stevenrombauts/repos","events_url":"https://api.github.com/users/stevenrombauts/events{/privacy}","received_events_url":"https://api.github.com/users/stevenrombauts/received_events","type":"User","site_admin":false},"created_at":"2015-09-03T09:42:48Z","updated_at":"2015-09-03T09:42:48Z","body":"This is looking good. I would make a clear distinction between  the following API's. \n\n- PHP API\n- Web API\n- Event API (Would not name this Relevant Plugin Events as the events are useful everywhere, not only in plugins).\n\nYour start description would then be something like :\n\nThe DOCman Web API is a Restful JSON API. The default JSON response documents are inspired by the JSON API specification. For a deeper look at how the core JSON format actually gets built have a look our write up about JSON at http://guides.nooku.org/JSON.html .\n\nNote : the whole fact that our Joomlatools extensions are build on Nooku is not somethign we need to repeat everywhere. This is something for the framework docs. \n\nAlso here we would have a parent framework/api page that contains the generic information about the API itself with the relevant links to Nooku. "}}