Provide clarity about what we can and cannot support (#1314)

* First swing at support page

* Add hexo-include-markdown

* Move CONTRIBUTING.md to .github

* Update .github/SUPPORT.md

* Channel issues in the  GitHub tracker

* Inject integration help MD into website

* Fix include_markdown path

* Inject CONTRIBUTING in the same fashion as support options

* Flesh out support policy

* Inject into website

* Tweaks

* Update website/update.js

* Update website/src/_template/support.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* iterating

* iterate

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update website/src/support.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update website/src/_template/integration_help.md

* iterate

* Migrate to a table

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* WIP

* wip

* Update website/src/_template/integration_help.md

* Update .github/ISSUE_TEMPLATE/integration_help.md

* Add touch module

* Replace shelling out to GNU `sed` with native node

* Update website/update.js

* Inject new .github copies

* Move the pricing table to the website only /cc @arturi

* Update website/src/support.md

* Update website/src/support.md

* Update .github/CONTRIBUTING.md

* Update website/src/_template/contributing.md

.github/CONTRIBUTING.md

@@ -0,0 +1,248 @@
+## Uppy development
+
+Fork the repository into your own account first. See the [GitHub Help](https://help.github.com/articles/fork-a-repo/) article for instructions.
+
+After you have successfully forked the repo, clone and install the project:
+
+```bash
+git clone git@github.com:YOUR_USERNAME/uppy.git
+cd uppy
+npm install
+npm run bootstrap
+```
+
+We use lerna to manage the many plugin packages Uppy has. You should always do `npm run bootstrap` after an `npm install` to make sure lerna has installed the dependencies of each package and that the `package-lock.json` in the repository root is up to date.
+
+Our website’s examples section is also our playground, please read the [Local Previews](#Local-Previews) section to get up and running.
+
+## Tests
+
+Unit tests are using Jest and can be run with:
+
+```bash
+npm run test:unit
+```
+
+For acceptance (or end-to-end) tests, we use [Webdriverio](http://webdriver.io). For it to run locally, you need to install a Selenium standalone server. Just follow [the guide](http://webdriver.io/guide.html) to do so. You can also install a Selenium standalone server from NPM:
+
+```bash
+npm install selenium-standalone -g
+selenium-standalone install
+```
+
+And then launch it:
+
+```bash
+selenium-standalone start
+```
+
+After you have installed and launched the selenium standalone server, run:
+
+```bash
+npm run test:acceptance:local
+```
+
+By default, `test:acceptance:local` uses Firefox. You can use a different browser, like Chrome, by passing the `-b` flag:
+
+```bash
+npm run test:acceptance:local -- -b chrome
+```
+
+> Note: The `--` is important, it tells npm that the remaining arguments should be interpreted by the script itself, not by npm.
+
+You can run in multiple browsers by passing multiple `-b` flags:
+
+```bash
+npm run test:acceptance:local -- -b chrome -b firefox
+```
+
+When trying to get a specific integration test to pass, it's not that helpful to continuously run _all_ tests. You can use the `--suite` flag to run tests from a single `./test/endtoend` folder. For example, `--suite thumbnails` will only run the tests from `./test/endtoend/thumbnails`. Of course, it can also be combined with one or more `-b` flags.
+
+```bash
+npm run test:acceptance:local -- -b chrome --suite thumbnails
+```
+
+These tests are also run automatically on Travis builds with [SauceLabs](https://saucelabs.com/) cloud service using different OSes.
+
+## Releases
+
+Before doing a release, check that the examples on the website work:
+
+```bash
+npm start
+open http://localhost:4000/examples/dashboard
+```
+
+Also check the other examples:
+
+```bash
+cd examples/EXAMPLENAME
+npm install
+npm start
+```
+
+Releases are managed by [Lerna](https://github.com/lerna/lerna/tree/2.x). We do some cleanup and compile work around releases too. Use the npm release script:
+
+```bash
+npm run release
+```
+
+If you have two factor authentication enabled on your npm account, you will need to temporarily disable it when doing an uppy release. Lerna doesn't support 2FA, and while there are workarounds, they don't reliably work for us. (In particular, using the `npm_config_otp` environment variable will fail because the token expires by the time the release script starts publishing anything.)
+
+```bash
+npm profile disable-2fa
+npm run release
+npm profile enable-2fa auth-only
+```
+
+Other things to keep in mind during release:
+
+* When doing a minor release below 1.0, or a major release >= 1.0, of the `@uppy/core` package, the peerDependency of the plugin packages needs to be updated first. Eg when updating from 0.25.5 to 0.26.0, the peerDependency of each should be `"@uppy/core": "^0.26.0"` before doing `npm run release`.
+* When publishing a new package, publish it manually first with `npm publish --access public`, since by default `@`-prefixed packages are private on NPM, and Lerna will fail.
+
+After a release, the demos on transloadit.com should also be updated. After updating, check that some things work locally:
+
+ - the demos in the demo section work (try one that uses an import robot, and one that you need to upload to)
+ - the demos on the homepage work and can import from GDrive, Insta, Dropbox
+
+If you don't have access to the transloadit.com source code ping @arturi or @goto-bus-stop and we'll pick it up. :sparkles:
+
+## Website development
+
+We keep the [uppy.io](http://uppy.io) website in `./website`, so it’s easy to keep docs and code in sync as we are still iterating at high velocity.
+
+The site is built with [Hexo](http://hexo.io/), and Travis automatically deploys this onto GitHub Pages (it overwrites the `gh-pages` branch with Hexo's build at every change to `master`). The content is written in Markdown and located in `./website/src`. Feel free to fork & hack!
+
+Even though bundled in this repo, the website is regarded as a separate project. As such, it has its own `package.json` and we aim to keep the surface where the two projects interface as small as possible. `./website/update.js` is called during website builds to inject the Uppy knowledge into the site.
+
+### Local previews
+
+It is recommended to exclude `./website/public/` from your editor if you want efficient searches.
+
+To install the required node modules, type:
+
+```bash
+npm install && cd website && npm install && cd ..
+```
+
+For local previews on http://localhost:4000, type:
+
+```bash
+npm start
+```
+
+This will watch the website, as well as Uppy, as the examples, and rebuild everything and refresh your browser as files change.
+
+Then, to work on, for instance, the XHRUpload example, you would edit the following files:
+
+```bash
+${EDITOR} src/core/Core.js \
+  src/plugins/XHRUpload.js \
+  src/plugins/Plugin.js \
+  website/src/examples/xhrupload/app.es6
+```
+
+And open <http://localhost:4000/examples/xhrupload/> in your web browser.
+
+## CSS guidelines
+
+The CSS standards followed in this project closely resemble those from [Medium's CSS Guidelines](https://gist.github.com/fat/a47b882eb5f84293c4ed). If something is not mentioned here, follow their guidelines.
+
+### Naming conventions
+
+This project uses naming conventions adopted from the SUIT CSS framework.
+[Read about them here](https://github.com/suitcss/suit/blob/master/doc/naming-conventions.md).
+
+To quickly summarize:
+
+#### Utilities
+
+Syntax: u-[sm-|md-|lg-]<utilityName>
+
+```css
+.u-utilityName
+.u-floatLeft
+.u-lg-col6
+```
+
+#### Components
+
+Syntax: [<namespace>-]<ComponentName>[-descendentName][--modifierName]
+
+```css
+.twt-Button /* Namespaced component */
+.MyComponent /* Components pascal cased */
+.Button--default /* Modified button style */
+.Button--large
+
+.Tweet
+.Tweet-header /* Descendents */
+.Tweet-bodyText
+
+.Accordion.is-collapsed /* State of component */
+.Accordion.is-expanded
+```
+
+### SASS
+
+This project uses SASS, with some limitations on nesting.  One-level-deep nesting is allowed, but nesting may not extend a selector by using the `&` operator.  For example:
+
+```sass
+/* BAD */
+.Button {
+  &--disabled {
+    ...
+  }
+}
+
+/* GOOD */
+.Button {
+  ...
+}
+
+.Button--disabled {
+  ...
+}
+```
+
+### Mobile-first responsive approach
+
+Style to the mobile breakpoint with your selectors, then use `min-width` media queries to add any styles to the tablet or desktop breakpoints.
+
+### Selector, rule ordering
+
+- All selectors are sorted alphabetically and by type.
+- HTML elements go above classes and IDs in a file.
+- Rules are sorted alphabetically.
+
+```sass
+/* BAD */
+.wrapper {
+  width: 940px;
+  margin: auto;
+}
+
+h1 {
+  color: red;
+}
+
+.article {
+  width: 100%;
+  padding: 32px;
+}
+
+/* GOOD */
+h1 {
+  color: red;
+}
+
+.article {
+  padding: 32px;
+  width: 100%;
+}
+
+.wrapper {
+  margin: auto;
+  width: 940px;
+}
+```

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,5 @@
+---
+name: Bug report
+about: Let us know about an unexpected error, a crash, or an incorrect behavior.
+labels: Bug, Triage
+---

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,5 @@
+---
+name: Feature request
+about: Suggest a new feature or other enhancement.
+labels: Feature, Triage
+---

.github/ISSUE_TEMPLATE/integration_help.md

@@ -0,0 +1,13 @@
+---
+name: Integration help
+about: Do you need assistance with building the Uppy client in your bundler, or running Companion on your own preferred server platform?
+labels: Not Accepted
+---
+
+We are providing Uppy free of charge. If you want you can self-host all components and never pay us anything. There's docs and tests and your Bugs and Feature Requests are always welcome on GitHub. 
+
+There is also a different category of support that we'd like to call Integration Help: making things work for you, that are already reported working for the larger community.
+
+As much as we'd like to provide detailed integration help to each non-paying user, Uppy has reached a point where this is no longer sustainable for our small crew. We end up investing our time in a million different projects, but without money flowing back, we can't ramp up our team along with the demand, spreading our team ever thinner, eventually grinding development to a halt.
+
+This is not where we want to be, so in order to offer enthusiasts, businesses, and enterprises assistance in a sustainable way, we're providing community based integration help for free at <https://community.transloadit.com/c/uppy>, and offer business paid support via <https://uppy.io/support>.

CONTRIBUTING.md

@@ -1,3 +0,0 @@
-Please refer to our:
-
-- Contributor's guide in [`website/src/docs/contributing.md`](https://github.com/transloadit/uppy/blob/master/website/src/docs/contributing.md)

package.json

@@ -71,6 +71,7 @@
     "tinyify": "^2.4.3",
     "tsify": "^4.0.1",
     "typescript": "^2.9.2",
+    "touch": "^3.1.0",
     "verdaccio": "^3.11.4",
     "watchify": "^3.11.0",
     "wdio-mocha-framework": "^0.6.4",

website/_config.yml

@@ -149,3 +149,7 @@ skip_render:
 
 alias:
   examples/: examples/dashboard/
+
+include_markdown:
+  dir: "src/_template"   # Base directory of template markdown
+  verbose : true    

website/package-lock.json

@@ -2871,13 +2871,11 @@
         },
         "balanced-match": {
           "version": "1.0.0",
-          "bundled": true,
-          "optional": true
+          "bundled": true
         },
         "brace-expansion": {
           "version": "1.1.11",
           "bundled": true,
-          "optional": true,
           "requires": {
             "balanced-match": "^1.0.0",
             "concat-map": "0.0.1"
@@ -2890,18 +2888,15 @@
         },
         "code-point-at": {
           "version": "1.1.0",
-          "bundled": true,
-          "optional": true
+          "bundled": true
         },
         "concat-map": {
           "version": "0.0.1",
-          "bundled": true,
-          "optional": true
+          "bundled": true
         },
         "console-control-strings": {
           "version": "1.1.0",
-          "bundled": true,
-          "optional": true
+          "bundled": true
         },
         "core-util-is": {
           "version": "1.0.2",
@@ -3004,8 +2999,7 @@
         },
         "inherits": {
           "version": "2.0.3",
-          "bundled": true,
-          "optional": true
+          "bundled": true
         },
         "ini": {
           "version": "1.3.5",
@@ -3015,7 +3009,6 @@
         "is-fullwidth-code-point": {
           "version": "1.0.0",
           "bundled": true,
-          "optional": true,
           "requires": {
             "number-is-nan": "^1.0.0"
           }
@@ -3028,20 +3021,17 @@
         "minimatch": {
           "version": "3.0.4",
           "bundled": true,
-          "optional": true,
           "requires": {
             "brace-expansion": "^1.1.7"
           }
         },
         "minimist": {
           "version": "0.0.8",
-          "bundled": true,
-          "optional": true
+          "bundled": true
         },
         "minipass": {
           "version": "2.2.4",
           "bundled": true,
-          "optional": true,
           "requires": {
             "safe-buffer": "^5.1.1",
             "yallist": "^3.0.0"
@@ -3058,7 +3048,6 @@
         "mkdirp": {
           "version": "0.5.1",
           "bundled": true,
-          "optional": true,
           "requires": {
             "minimist": "0.0.8"
           }
@@ -3131,8 +3120,7 @@
         },
         "number-is-nan": {
           "version": "1.0.1",
-          "bundled": true,
-          "optional": true
+          "bundled": true
         },
         "object-assign": {
           "version": "4.1.1",
@@ -3142,7 +3130,6 @@
         "once": {
           "version": "1.4.0",
           "bundled": true,
-          "optional": true,
           "requires": {
             "wrappy": "1"
           }
@@ -3248,7 +3235,6 @@
         "string-width": {
           "version": "1.0.2",
           "bundled": true,
-          "optional": true,
           "requires": {
             "code-point-at": "^1.0.0",
             "is-fullwidth-code-point": "^1.0.0",
@@ -3946,6 +3932,11 @@
         "sprintf-js": "^1.0.2"
       }
     },
+    "hexo-include-markdown": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/hexo-include-markdown/-/hexo-include-markdown-1.0.2.tgz",
+      "integrity": "sha1-EIHjsCQywxXQahsssrnZIEeLZEg="
+    },
     "hexo-log": {
       "version": "0.2.0",
       "resolved": "https://registry.npmjs.org/hexo-log/-/hexo-log-0.2.0.tgz",

website/package.json

@@ -17,6 +17,7 @@
     "hexo-generator-feed": "^1.2.2",
     "hexo-generator-index": "^0.2.1",
     "hexo-generator-tag": "^0.2.0",
+    "hexo-include-markdown": "^1.0.2",
     "hexo-renderer-ejs": "^0.3.1",
     "hexo-renderer-marked": "^0.3.2",
     "hexo-renderer-postcss": "git+https://github.com/arturi/hexo-renderer-postcss.git",

website/src/_template/contributing.md

@@ -0,0 +1,250 @@
+<!-- WARNING! This file was injected. Please edit in ".github/CONTRIBUTING.md" instead and run "update.js" -->
+
+## Uppy development
+
+Fork the repository into your own account first. See the [GitHub Help](https://help.github.com/articles/fork-a-repo/) article for instructions.
+
+After you have successfully forked the repo, clone and install the project:
+
+```bash
+git clone git@github.com:YOUR_USERNAME/uppy.git
+cd uppy
+npm install
+npm run bootstrap
+```
+
+We use lerna to manage the many plugin packages Uppy has. You should always do `npm run bootstrap` after an `npm install` to make sure lerna has installed the dependencies of each package and that the `package-lock.json` in the repository root is up to date.
+
+Our website’s examples section is also our playground, please read the [Local Previews](#Local-Previews) section to get up and running.
+
+## Tests
+
+Unit tests are using Jest and can be run with:
+
+```bash
+npm run test:unit
+```
+
+For acceptance (or end-to-end) tests, we use [Webdriverio](http://webdriver.io). For it to run locally, you need to install a Selenium standalone server. Just follow [the guide](http://webdriver.io/guide.html) to do so. You can also install a Selenium standalone server from NPM:
+
+```bash
+npm install selenium-standalone -g
+selenium-standalone install
+```
+
+And then launch it:
+
+```bash
+selenium-standalone start
+```
+
+After you have installed and launched the selenium standalone server, run:
+
+```bash
+npm run test:acceptance:local
+```
+
+By default, `test:acceptance:local` uses Firefox. You can use a different browser, like Chrome, by passing the `-b` flag:
+
+```bash
+npm run test:acceptance:local -- -b chrome
+```
+
+> Note: The `--` is important, it tells npm that the remaining arguments should be interpreted by the script itself, not by npm.
+
+You can run in multiple browsers by passing multiple `-b` flags:
+
+```bash
+npm run test:acceptance:local -- -b chrome -b firefox
+```
+
+When trying to get a specific integration test to pass, it's not that helpful to continuously run _all_ tests. You can use the `--suite` flag to run tests from a single `./test/endtoend` folder. For example, `--suite thumbnails` will only run the tests from `./test/endtoend/thumbnails`. Of course, it can also be combined with one or more `-b` flags.
+
+```bash
+npm run test:acceptance:local -- -b chrome --suite thumbnails
+```
+
+These tests are also run automatically on Travis builds with [SauceLabs](https://saucelabs.com/) cloud service using different OSes.
+
+## Releases
+
+Before doing a release, check that the examples on the website work:
+
+```bash
+npm start
+open http://localhost:4000/examples/dashboard
+```
+
+Also check the other examples:
+
+```bash
+cd examples/EXAMPLENAME
+npm install
+npm start
+```
+
+Releases are managed by [Lerna](https://github.com/lerna/lerna/tree/2.x). We do some cleanup and compile work around releases too. Use the npm release script:
+
+```bash
+npm run release
+```
+
+If you have two factor authentication enabled on your npm account, you will need to temporarily disable it when doing an uppy release. Lerna doesn't support 2FA, and while there are workarounds, they don't reliably work for us. (In particular, using the `npm_config_otp` environment variable will fail because the token expires by the time the release script starts publishing anything.)
+
+```bash
+npm profile disable-2fa
+npm run release
+npm profile enable-2fa auth-only
+```
+
+Other things to keep in mind during release:
+
+* When doing a minor release below 1.0, or a major release >= 1.0, of the `@uppy/core` package, the peerDependency of the plugin packages needs to be updated first. Eg when updating from 0.25.5 to 0.26.0, the peerDependency of each should be `"@uppy/core": "^0.26.0"` before doing `npm run release`.
+* When publishing a new package, publish it manually first with `npm publish --access public`, since by default `@`-prefixed packages are private on NPM, and Lerna will fail.
+
+After a release, the demos on transloadit.com should also be updated. After updating, check that some things work locally:
+
+ - the demos in the demo section work (try one that uses an import robot, and one that you need to upload to)
+ - the demos on the homepage work and can import from GDrive, Insta, Dropbox
+
+If you don't have access to the transloadit.com source code ping @arturi or @goto-bus-stop and we'll pick it up. :sparkles:
+
+## Website development
+
+We keep the [uppy.io](http://uppy.io) website in `./website`, so it’s easy to keep docs and code in sync as we are still iterating at high velocity.
+
+The site is built with [Hexo](http://hexo.io/), and Travis automatically deploys this onto GitHub Pages (it overwrites the `gh-pages` branch with Hexo's build at every change to `master`). The content is written in Markdown and located in `./website/src`. Feel free to fork & hack!
+
+Even though bundled in this repo, the website is regarded as a separate project. As such, it has its own `package.json` and we aim to keep the surface where the two projects interface as small as possible. `./website/update.js` is called during website builds to inject the Uppy knowledge into the site.
+
+### Local previews
+
+It is recommended to exclude `./website/public/` from your editor if you want efficient searches.
+
+To install the required node modules, type:
+
+```bash
+npm install && cd website && npm install && cd ..
+```
+
+For local previews on http://localhost:4000, type:
+
+```bash
+npm start
+```
+
+This will watch the website, as well as Uppy, as the examples, and rebuild everything and refresh your browser as files change.
+
+Then, to work on, for instance, the XHRUpload example, you would edit the following files:
+
+```bash
+${EDITOR} src/core/Core.js \
+  src/plugins/XHRUpload.js \
+  src/plugins/Plugin.js \
+  website/src/examples/xhrupload/app.es6
+```
+
+And open <http://localhost:4000/examples/xhrupload/> in your web browser.
+
+## CSS guidelines
+
+The CSS standards followed in this project closely resemble those from [Medium's CSS Guidelines](https://gist.github.com/fat/a47b882eb5f84293c4ed). If something is not mentioned here, follow their guidelines.
+
+### Naming conventions
+
+This project uses naming conventions adopted from the SUIT CSS framework.
+[Read about them here](https://github.com/suitcss/suit/blob/master/doc/naming-conventions.md).
+
+To quickly summarize:
+
+#### Utilities
+
+Syntax: u-[sm-|md-|lg-]<utilityName>
+
+```css
+.u-utilityName
+.u-floatLeft
+.u-lg-col6
+```
+
+#### Components
+
+Syntax: [<namespace>-]<ComponentName>[-descendentName][--modifierName]
+
+```css
+.twt-Button /* Namespaced component */
+.MyComponent /* Components pascal cased */
+.Button--default /* Modified button style */
+.Button--large
+
+.Tweet
+.Tweet-header /* Descendents */
+.Tweet-bodyText
+
+.Accordion.is-collapsed /* State of component */
+.Accordion.is-expanded
+```
+
+### SASS
+
+This project uses SASS, with some limitations on nesting.  One-level-deep nesting is allowed, but nesting may not extend a selector by using the `&` operator.  For example:
+
+```sass
+/* BAD */
+.Button {
+  &--disabled {
+    ...
+  }
+}
+
+/* GOOD */
+.Button {
+  ...
+}
+
+.Button--disabled {
+  ...
+}
+```
+
+### Mobile-first responsive approach
+
+Style to the mobile breakpoint with your selectors, then use `min-width` media queries to add any styles to the tablet or desktop breakpoints.
+
+### Selector, rule ordering
+
+- All selectors are sorted alphabetically and by type.
+- HTML elements go above classes and IDs in a file.
+- Rules are sorted alphabetically.
+
+```sass
+/* BAD */
+.wrapper {
+  width: 940px;
+  margin: auto;
+}
+
+h1 {
+  color: red;
+}
+
+.article {
+  width: 100%;
+  padding: 32px;
+}
+
+/* GOOD */
+h1 {
+  color: red;
+}
+
+.article {
+  padding: 32px;
+  width: 100%;
+}
+
+.wrapper {
+  margin: auto;
+  width: 940px;
+}
+```

website/src/_template/integration_help.md

@@ -0,0 +1,9 @@
+<!-- WARNING! This file was injected. Please edit in ".github/ISSUE_TEMPLATE/integration_help.md" instead and run "update.js" -->
+
+We are providing Uppy free of charge. If you want you can self-host all components and never pay us anything. There's docs and tests and your Bugs and Feature Requests are always welcome on GitHub. 
+
+There is also a different category of support that we'd like to call Integration Help: making things work for you, that are already reported working for the larger community.
+
+As much as we'd like to provide detailed integration help to each non-paying user, Uppy has reached a point where this is no longer sustainable for our small crew. We end up investing our time in a million different projects, but without money flowing back, we can't ramp up our team along with the demand, spreading our team ever thinner, eventually grinding development to a halt.
+
+This is not where we want to be, so in order to offer enthusiasts, businesses, and enterprises assistance in a sustainable way, we're providing community based integration help for free at <https://community.transloadit.com/c/uppy>, and offer business paid support via <https://uppy.io/support>.

website/src/docs/contributing.md

@@ -4,251 +4,4 @@ type: docs
 order: 5
 ---
 
-## Uppy development
-
-Fork the repository into your own account first. See the [GitHub Help](https://help.github.com/articles/fork-a-repo/) article for instructions.
-
-After you have successfully forked the repo, clone and install the project:
-
-```bash
-git clone git@github.com:YOUR_USERNAME/uppy.git
-cd uppy
-npm install
-npm run bootstrap
-```
-
-We use lerna to manage the many plugin packages Uppy has. You should always do `npm run bootstrap` after an `npm install` to make sure lerna has installed the dependencies of each package and that the `package-lock.json` in the repository root is up to date.
-
-Our website’s examples section is also our playground, please read the [Local Previews](#Local-Previews) section to get up and running.
-
-## Tests
-
-Unit tests are using Jest and can be run with:
-
-```bash
-npm run test:unit
-```
-
-For acceptance (or end-to-end) tests, we use [Webdriverio](http://webdriver.io). For it to run locally, you need to install a Selenium standalone server. Just follow [the guide](http://webdriver.io/guide.html) to do so. You can also install a Selenium standalone server from NPM:
-
-```bash
-npm install selenium-standalone -g
-selenium-standalone install
-```
-
-And then launch it:
-
-```bash
-selenium-standalone start
-```
-
-After you have installed and launched the selenium standalone server, run:
-
-```bash
-npm run test:acceptance:local
-```
-
-By default, `test:acceptance:local` uses Firefox. You can use a different browser, like Chrome, by passing the `-b` flag:
-
-```bash
-npm run test:acceptance:local -- -b chrome
-```
-
-> Note: The `--` is important, it tells npm that the remaining arguments should be interpreted by the script itself, not by npm.
-
-You can run in multiple browsers by passing multiple `-b` flags:
-
-```bash
-npm run test:acceptance:local -- -b chrome -b firefox
-```
-
-When trying to get a specific integration test to pass, it's not that helpful to continuously run _all_ tests. You can use the `--suite` flag to run tests from a single `./test/endtoend` folder. For example, `--suite thumbnails` will only run the tests from `./test/endtoend/thumbnails`. Of course, it can also be combined with one or more `-b` flags.
-
-```bash
-npm run test:acceptance:local -- -b chrome --suite thumbnails
-```
-
-These tests are also run automatically on Travis builds with [SauceLabs](https://saucelabs.com/) cloud service using different OSes.
-
-## Releases
-
-Before doing a release, check that the examples on the website work:
-
-```bash
-npm start
-open http://localhost:4000/examples/dashboard
-```
-
-Also check the other examples:
-
-```bash
-cd examples/EXAMPLENAME
-npm install
-npm start
-```
-
-Releases are managed by [Lerna](https://github.com/lerna/lerna/tree/2.x). We do some cleanup and compile work around releases too. Use the npm release script:
-
-```bash
-npm run release
-```
-
-If you have two factor authentication enabled on your npm account, you will need to temporarily disable it when doing an uppy release. Lerna doesn't support 2FA, and while there are workarounds, they don't reliably work for us. (In particular, using the `npm_config_otp` environment variable will fail because the token expires by the time the release script starts publishing anything.)
-
-```bash
-npm profile disable-2fa
-npm run release
-npm profile enable-2fa auth-only
-```
-
-Other things to keep in mind during release:
-
-* When doing a minor release below 1.0, or a major release >= 1.0, of the `@uppy/core` package, the peerDependency of the plugin packages needs to be updated first. Eg when updating from 0.25.5 to 0.26.0, the peerDependency of each should be `"@uppy/core": "^0.26.0"` before doing `npm run release`.
-* When publishing a new package, publish it manually first with `npm publish --access public`, since by default `@`-prefixed packages are private on NPM, and Lerna will fail.
-
-After a release, the demos on transloadit.com should also be updated. After updating, check that some things work locally:
-
- - the demos in the demo section work (try one that uses an import robot, and one that you need to upload to)
- - the demos on the homepage work and can import from GDrive, Insta, Dropbox
-
-If you don't have access to the transloadit.com source code ping @arturi or @goto-bus-stop and we'll pick it up. :sparkles:
-
-## Website development
-
-We keep the [uppy.io](http://uppy.io) website in `./website`, so it’s easy to keep docs and code in sync as we are still iterating at high velocity.
-
-The site is built with [Hexo](http://hexo.io/), and Travis automatically deploys this onto GitHub Pages (it overwrites the `gh-pages` branch with Hexo's build at every change to `master`). The content is written in Markdown and located in `./website/src`. Feel free to fork & hack!
-
-Even though bundled in this repo, the website is regarded as a separate project. As such, it has its own `package.json` and we aim to keep the surface where the two projects interface as small as possible. `./website/update.js` is called during website builds to inject the Uppy knowledge into the site.
-
-### Local previews
-
-It is recommended to exclude `./website/public/` from your editor if you want efficient searches.
-
-To install the required node modules, type:
-
-```bash
-npm install && cd website && npm install && cd ..
-```
-
-For local previews on http://127.0.0.1:4000, type:
-
-```bash
-npm start
-```
-
-This will watch the website, as well as Uppy, as the examples, and rebuild everything and refresh your browser as files change.
-
-Then, to work on, for instance, the XHRUpload example, you would edit the following files:
-
-```bash
-atom src/core/Core.js \
-  src/plugins/XHRUpload.js \
-  src/plugins/Plugin.js \
-  website/src/examples/xhrupload/app.es6
-```
-
-And open <http://0.0.0.0:4000/examples/xhrupload/> in your web browser.
-
-## CSS guidelines
-
-The CSS standards followed in this project closely resemble those from [Medium's CSS Guidelines](https://gist.github.com/fat/a47b882eb5f84293c4ed). If something is not mentioned here, follow their guidelines.
-
-### Naming conventions
-
-This project uses naming conventions adopted from the SUIT CSS framework.
-[Read about them here](https://github.com/suitcss/suit/blob/master/doc/naming-conventions.md).
-
-To quickly summarize:
-
-#### Utilities
-
-Syntax: u-[sm-|md-|lg-]<utilityName>
-
-```css
-.u-utilityName
-.u-floatLeft
-.u-lg-col6
-```
-
-#### Components
-
-Syntax: [<namespace>-]<ComponentName>[-descendentName][--modifierName]
-
-```css
-.twt-Button /* Namespaced component */
-.MyComponent /* Components pascal cased */
-.Button--default /* Modified button style */
-.Button--large
-
-.Tweet
-.Tweet-header /* Descendents */
-.Tweet-bodyText
-
-.Accordion.is-collapsed /* State of component */
-.Accordion.is-expanded
-```
-
-### SASS
-
-This project uses SASS, with some limitations on nesting.  One-level-deep nesting is allowed, but nesting may not extend a selector by using the `&` operator.  For example:
-
-```sass
-/* BAD */
-.Button {
-  &--disabled {
-    ...
-  }
-}
-
-/* GOOD */
-.Button {
-  ...
-}
-
-.Button--disabled {
-  ...
-}
-```
-
-### Mobile-first responsive approach
-
-Style to the mobile breakpoint with your selectors, then use `min-width` media queries to add any styles to the tablet or desktop breakpoints.
-
-### Selector, rule ordering
-
-- All selectors are sorted alphabetically and by type.
-- HTML elements go above classes and IDs in a file.
-- Rules are sorted alphabetically.
-
-```sass
-/* BAD */
-.wrapper {
-  width: 940px;
-  margin: auto;
-}
-
-h1 {
-  color: red;
-}
-
-.article {
-  width: 100%;
-  padding: 32px;
-}
-
-/* GOOD */
-h1 {
-  color: red;
-}
-
-.article {
-  padding: 32px;
-  width: 100%;
-}
-
-.wrapper {
-  margin: auto;
-  width: 940px;
-}
-```
+<!-- md contributing.md -->

website/src/support.md

@@ -0,0 +1,37 @@
+---
+title: "Uppy Support Options"
+type: page
+layout: page
+permalink: /support/
+---
+
+<!-- md integration_help.md -->
+
+This approach is new, we may make changes as we learn. Here are the current options in detail:
+
+|                                   <br>Support |   🦄<br>Community    |                        🥉<br>Bronze                         |                                🥈<br>Silver and up                                |
+|----------------------------------------------:|:--------------------:|:-----------------------------------------------------------:|:---------------------------------------------------------------------------------:|
+|                                         Price |      anyone, $0      |           included for all Transloadit Customers            |                 Enterprise support packages starting at $1499/mo                  |
+|                                   Bug reports |   ✅ [GitHub][bugs]   |                      ✅ [GitHub][bugs]                       |                                 ✅ [GitHub][bugs]                                  |
+|                              Feature requests | ✅ [GitHub][features] |                    ✅ [GitHub][features]                     |                   ✅ [GitHub][features] & [Transloadit][support]                   |
+|                              Integration Help | ✅ [Community][forum] | ✅ [Transloadit][support]<br>(announce your account's email) |            ✅ [Transloadit][support]<br>(announce your account's email)            |
+|                                         Depth |       varying        |                     ✅ General Guidance                      |  ✅ Guidance based on your use-case and circumstances, code & operational reviews  |
+|                        Support on Uppy client |     best effort      |                              ✅                              |                                         ✅                                         |
+| Support on Transloadit-hosted Companion & Tus |     best effort      |                              ✅                              |                                         ✅                                         |
+|        Support on self-hosted Companion & Tus |     best effort      |                              -                              |                                         ✅                                         |
+|  Access to Transloadit-hosted Companion & Tus |          -           |                              ✅                              |                                         ✅                                         |
+|     Access to Transloadit's encoding features |          -           |                       ✅ 10GB included                       |                                 ✅ 0GB - unlimited                                 |
+| Guaranteed response times within office hours |          -           |                          < 4 days                           |                                    < 8h - 32h                                     |
+|              1-on-1 access to core developers |          -           |                             1h                              |                                     1h - 20h                                      |
+|                               Health & Status |          -           |         ✅ Access to Personal Transloadit Dashboard          | ✅ Access to Personal Transloadit Dashboard. Proactive monitoring & notifications. |
+|              Support for non-current releases |          -           |                              -                              |                              ✅ 0 - 10 releases back                               |
+
+For all questions we recommend first checking out the [Community Forum][forum] as the answer may already be there, and it's a nice place to hang out. If you're interested in 🥉 Bronze support, all you need to do is [sign up for the Startup plan here][pricing]. If you're interested in 🥈 Silver or 🥇 higher and you are not a customer yet, [reach out](mailto:support@transloadit.com?subject=Uppy+Enterprise+Support).
+
+[bugs]: https://github.com/transloadit/uppy/issues/new?template=bug_reports.md  "Bugs welcome in the issue tracker on GitHub"
+[features]: https://github.com/transloadit/uppy/issues/new?template=feature_request.md "Feature requests welcome in the issue tracker on GitHub"
+[forum]: https://community.transloadit.com/c/uppy "Community Forum"
+[pricing]: https://transloadit/pricing/ "Transloadit plans & signup"
+[support]: https://transloadit/support/ "Transloadit Support"
+
+

website/themes/uppy/layout/partials/main_menu.ejs

@@ -9,4 +9,5 @@
 <li><a href="/examples/dashboard/" class="nav-link<%- page.path.match(/examples/) ? ' current' : '' %>">Examples</a></li>
 <!--li><a href="/stats/" class="nav-link<%- page.path.match(/stats/) ? ' current' : '' %>">Stats</a></li-->
 <li><a href="/blog/" class="nav-link<%- page.path.match(/blog/) ? ' current' : '' %>">Blog</a></li>
+<li><a href="/support/" class="nav-link<%- page.path.match(/support/) ? ' current' : '' %>">Support</a></li>
 <li><a href="https://github.com/transloadit/uppy" class="nav-link">Github</a></li>

website/update.js

@@ -7,6 +7,7 @@ const { promisify } = require('util')
 const gzipSize = require('gzip-size')
 const bytes = require('pretty-bytes')
 const browserify = require('browserify')
+const touch = require('touch')
 
 const webRoot = __dirname
 const uppyRoot = path.join(__dirname, '../packages/uppy')
@@ -120,6 +121,30 @@ async function injectBuiltFiles () {
   })
 }
 
+async function injectMarkdown () {
+  let sources = {
+    '.github/ISSUE_TEMPLATE/integration_help.md': `src/_template/integration_help.md`,
+    '.github/CONTRIBUTING.md': `src/_template/contributing.md`
+  }
+
+  for (let src in sources) {
+    let dst = sources[src]
+    // strip yaml frontmatter:
+    let srcpath = path.join(uppyRoot, `/../../${src}`)
+    let dstpath = path.join(webRoot, dst)
+    let parts = fs.readFileSync(srcpath, 'utf-8').split(/---\s*\n/)
+    if (parts.length >= 3) {
+      parts.shift()
+      parts.shift()
+    }
+    let content = `<!-- WARNING! This file was injected. Please edit in "${src}" instead and run "${path.basename(__filename)}" -->\n\n`
+    content += parts.join('---\n')
+    fs.writeFileSync(dstpath, content, 'utf-8')
+    console.info(chalk.green(`✓ injected: `), chalk.grey(srcpath))
+  }
+  touch(path.join(webRoot, `/src/support.md`))
+}
+
 async function readConfig () {
   try {
     const buf = await promisify(fs.readFile)(configPath, 'utf8')
@@ -132,6 +157,8 @@ async function readConfig () {
 async function update () {
   const config = await readConfig()
 
+  await injectMarkdown()
+
   config.uppy_version = version
   config.uppy_version_anchor = version.replace(/[^\d]+/g, '')
   await updateSizes(config)