{"action":"created","issue":{"url":"https://api.github.com/repos/rollup/rollup/issues/385","labels_url":"https://api.github.com/repos/rollup/rollup/issues/385/labels{/name}","comments_url":"https://api.github.com/repos/rollup/rollup/issues/385/comments","events_url":"https://api.github.com/repos/rollup/rollup/issues/385/events","html_url":"https://github.com/rollup/rollup/issues/385","id":124260847,"number":385,"title":"painful to get started","user":{"login":"boneskull","id":924465,"avatar_url":"https://avatars.githubusercontent.com/u/924465?v=3","gravatar_id":"","url":"https://api.github.com/users/boneskull","html_url":"https://github.com/boneskull","followers_url":"https://api.github.com/users/boneskull/followers","following_url":"https://api.github.com/users/boneskull/following{/other_user}","gists_url":"https://api.github.com/users/boneskull/gists{/gist_id}","starred_url":"https://api.github.com/users/boneskull/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/boneskull/subscriptions","organizations_url":"https://api.github.com/users/boneskull/orgs","repos_url":"https://api.github.com/users/boneskull/repos","events_url":"https://api.github.com/users/boneskull/events{/privacy}","received_events_url":"https://api.github.com/users/boneskull/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-12-29T20:00:24Z","updated_at":"2015-12-30T01:49:12Z","closed_at":null,"body":"This project needs some better tutorials or examples.  Here's my use case:\r\n\r\n1.  I have code written in ES2015; I am using Babel to transpile\r\n2.  I am also using npm dependencies\r\n3.  These dependencies (mainly) use CommonJS instead of ES2015 modules\r\n4.  This is a test runner with a programmatic API\r\n5.  The resulting build(s) must be runnable in Node.js, a browser, and a CLI context\r\n\r\nI've discovered the Babel plugin, the NPM plugin, and the CommonJS plugin.\r\nIt's unclear:\r\n\r\n1.  In what order the plugins are supposed to run\r\n2.  If order actually matters (though I'm pretty sure it does)\r\n3.  Why the CommonJS plugin and NPM plugin are separated at all\r\n4.  How to configure the Babel plugin to work with the above two plugins\r\n5.  Why the Babel plugin is necessary\r\n6.  Where Babel's responsibilities end and Rollup's begin--don't you need Babel to use `import` statements anyway?\r\n7.  If/when Browserify or Webpack is necessary\r\n8.  How to configure Karma to make my tests run in a browser\r\n9.  How to explain to my users, in a README, how to include my library given a matrix of potential configurations (Node.js, browser, Babel, no-Babel, Rollup, etc)\r\n10. When to use a config file or when and how to use a build script (`import rollup from 'rollup'`) \r\n\r\nI'm here asking these questions, there's probably 5 other people who had the same ones and didn't post an issue.  Surely I'd like my questions addressed, but the real need is more documentation.\r\n\r\nThanks!"},"comment":{"url":"https://api.github.com/repos/rollup/rollup/issues/comments/167915969","html_url":"https://github.com/rollup/rollup/issues/385#issuecomment-167915969","issue_url":"https://api.github.com/repos/rollup/rollup/issues/385","id":167915969,"user":{"login":"Rich-Harris","id":1162160,"avatar_url":"https://avatars.githubusercontent.com/u/1162160?v=3","gravatar_id":"","url":"https://api.github.com/users/Rich-Harris","html_url":"https://github.com/Rich-Harris","followers_url":"https://api.github.com/users/Rich-Harris/followers","following_url":"https://api.github.com/users/Rich-Harris/following{/other_user}","gists_url":"https://api.github.com/users/Rich-Harris/gists{/gist_id}","starred_url":"https://api.github.com/users/Rich-Harris/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Rich-Harris/subscriptions","organizations_url":"https://api.github.com/users/Rich-Harris/orgs","repos_url":"https://api.github.com/users/Rich-Harris/repos","events_url":"https://api.github.com/users/Rich-Harris/events{/privacy}","received_events_url":"https://api.github.com/users/Rich-Harris/received_events","type":"User","site_admin":false},"created_at":"2015-12-30T01:49:12Z","updated_at":"2015-12-30T01:49:12Z","body":"@boneskull this is awesome feedback, thanks! Have been thinking about producing some screencasts to help people get started – if I get round to it, these questions would provide a great starting point."}}