{"action":"created","issue":{"url":"https://api.github.com/repos/gulpjs/gulp/issues/1446","repository_url":"https://api.github.com/repos/gulpjs/gulp","labels_url":"https://api.github.com/repos/gulpjs/gulp/issues/1446/labels{/name}","comments_url":"https://api.github.com/repos/gulpjs/gulp/issues/1446/comments","events_url":"https://api.github.com/repos/gulpjs/gulp/issues/1446/events","html_url":"https://github.com/gulpjs/gulp/issues/1446","id":123389578,"number":1446,"title":"Gitbook plugin to mirror docs","user":{"login":"contra","id":425716,"avatar_url":"https://avatars.githubusercontent.com/u/425716?v=3","gravatar_id":"","url":"https://api.github.com/users/contra","html_url":"https://github.com/contra","followers_url":"https://api.github.com/users/contra/followers","following_url":"https://api.github.com/users/contra/following{/other_user}","gists_url":"https://api.github.com/users/contra/gists{/gist_id}","starred_url":"https://api.github.com/users/contra/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/contra/subscriptions","organizations_url":"https://api.github.com/users/contra/orgs","repos_url":"https://api.github.com/users/contra/repos","events_url":"https://api.github.com/users/contra/events{/privacy}","received_events_url":"https://api.github.com/users/contra/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/gulpjs/gulp/labels/documentation","name":"documentation","color":"bfe5bf"},{"url":"https://api.github.com/repos/gulpjs/gulp/labels/help%20wanted","name":"help wanted","color":"006b75"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/gulpjs/gulp/milestones/1","html_url":"https://github.com/gulpjs/gulp/milestones/gulp%204","labels_url":"https://api.github.com/repos/gulpjs/gulp/milestones/1/labels","id":603352,"number":1,"title":"gulp 4","description":"","creator":{"login":"contra","id":425716,"avatar_url":"https://avatars.githubusercontent.com/u/425716?v=3","gravatar_id":"","url":"https://api.github.com/users/contra","html_url":"https://github.com/contra","followers_url":"https://api.github.com/users/contra/followers","following_url":"https://api.github.com/users/contra/following{/other_user}","gists_url":"https://api.github.com/users/contra/gists{/gist_id}","starred_url":"https://api.github.com/users/contra/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/contra/subscriptions","organizations_url":"https://api.github.com/users/contra/orgs","repos_url":"https://api.github.com/users/contra/repos","events_url":"https://api.github.com/users/contra/events{/privacy}","received_events_url":"https://api.github.com/users/contra/received_events","type":"User","site_admin":false},"open_issues":13,"closed_issues":32,"state":"open","created_at":"2014-03-20T01:34:15Z","updated_at":"2016-04-05T22:12:08Z","due_on":null,"closed_at":null},"comments":3,"created_at":"2015-12-22T00:53:47Z","updated_at":"2016-04-11T20:29:36Z","closed_at":null,"body":"We should add a build script that pulls in the markdown docs from other projects\r\n\r\nExample: Our CLI.md in this repo is out of date with https://github.com/gulpjs/gulp-cli/blob/master/docs/CLI.md"},"comment":{"url":"https://api.github.com/repos/gulpjs/gulp/issues/comments/208545015","html_url":"https://github.com/gulpjs/gulp/issues/1446#issuecomment-208545015","issue_url":"https://api.github.com/repos/gulpjs/gulp/issues/1446","id":208545015,"user":{"login":"jonschlinkert","id":383994,"avatar_url":"https://avatars.githubusercontent.com/u/383994?v=3","gravatar_id":"","url":"https://api.github.com/users/jonschlinkert","html_url":"https://github.com/jonschlinkert","followers_url":"https://api.github.com/users/jonschlinkert/followers","following_url":"https://api.github.com/users/jonschlinkert/following{/other_user}","gists_url":"https://api.github.com/users/jonschlinkert/gists{/gist_id}","starred_url":"https://api.github.com/users/jonschlinkert/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jonschlinkert/subscriptions","organizations_url":"https://api.github.com/users/jonschlinkert/orgs","repos_url":"https://api.github.com/users/jonschlinkert/repos","events_url":"https://api.github.com/users/jonschlinkert/events{/privacy}","received_events_url":"https://api.github.com/users/jonschlinkert/received_events","type":"User","site_admin":false},"created_at":"2016-04-11T20:29:36Z","updated_at":"2016-04-11T20:29:36Z","body":"following up from https://twitter.com/BlaineBublitz/status/719612540636962816... \r\n\r\nI think it might help to give more detail on the types of projects do you want to inline. Then based on the relationships between the projects, and how automated you want it to be, we can more easily come up with an idea of what needs to be accomplished. \r\n\r\nFor example, do you want docs for dependencies/core libs? gulp plugins, etc?  Some thoughts/questions that come to mind that might help clarify what you'd like to achieve. Maybe none or all of these are relevant:\r\n\r\n- do you want to just inline the docs from other repos or do you want to actually merge docs if possible?  \r\n- do you want to do things like automatically cross-reference inherited methods?\r\n- we could also build up a context of urls to the docs, code and tests for dependencies, so links can be created in gulp docs using simple variables that will automatically update when urls change. \r\n\r\netc...\r\n\r\nfwiw this concept in general is something @doowb and I are really interested in.  we've spent thousands of hours on templating/markdown/documentation-related stuff b/c we see it as a huge productivity barrier in our space. so regardless of what you guys decide on I'm really curious/interested in the outcome. "}}