merge mochajs.github.io into mocha under docs/; closes #2987

Merge branch 'issue/2987-docs'

* issue/2987-docs: (272 commits)
  update node/npm requirements [ci skip]
  Mocha Sidebar: capitalization tweaks + remove huge gif [ci skip]
  Mocha Sidebar: fix wording [ci skip]
  add mocha side bar as extension for vs code [ci skip]
  update parameter order of example assert [ci skip]
  Improve description of --check-leaks option [ci skip]
  Update 'Arrow Function' wording for clarity. [ci skip]
  fix Gemfile [ci skip]
  migrate mochajs.github.io into mocha; closes #2987 [ci skip]
  move everything into docs/ in prep for moving repo into mocha proper
  Fix hyperlink for async_hooks
  add section on --exit / --no-exit
  update "Usage" and "--compilers" sections
  Fix typo in "Using async / await" snippet
  Update index.md
  Add `--inspect`
  **Bug** Edge renders the icon for a backer without an image to take up the entire screen.
  drop shx dependency
  chore(package): update shx to version 0.2.0
  fix hardcoded scheme in anchor.js url
  ...

# Conflicts:
#	.gitignore

.gitignore

@@ -20,3 +20,4 @@ mocha.js
 *_BASE_*
 *_LOCAL_*
 *_REMOTE_*
+docs/_site

Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+# Added at 2017-12-05 23:01:55 -0800 by boneskull:
+gem "jekyll", "~> 3.6"

Gemfile.lock

@@ -0,0 +1,50 @@
+GEM
+  specs:
+    addressable (2.5.2)
+      public_suffix (>= 2.0.2, < 4.0)
+    colorator (1.1.0)
+    ffi (1.9.18)
+    forwardable-extended (2.6.0)
+    jekyll (3.6.2)
+      addressable (~> 2.4)
+      colorator (~> 1.0)
+      jekyll-sass-converter (~> 1.0)
+      jekyll-watch (~> 1.1)
+      kramdown (~> 1.14)
+      liquid (~> 4.0)
+      mercenary (~> 0.3.3)
+      pathutil (~> 0.9)
+      rouge (>= 1.7, < 3)
+      safe_yaml (~> 1.0)
+    jekyll-sass-converter (1.5.0)
+      sass (~> 3.4)
+    jekyll-watch (1.5.1)
+      listen (~> 3.0)
+    kramdown (1.14.0)
+    liquid (4.0.0)
+    listen (3.0.8)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+    mercenary (0.3.6)
+    pathutil (0.16.0)
+      forwardable-extended (~> 2.6)
+    public_suffix (3.0.0)
+    rb-fsevent (0.10.2)
+    rb-inotify (0.9.10)
+      ffi (>= 0.5.0, < 2)
+    rouge (2.2.1)
+    safe_yaml (1.0.4)
+    sass (3.5.3)
+      sass-listen (~> 4.0.0)
+    sass-listen (4.0.0)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  jekyll (~> 3.6)
+
+BUNDLED WITH
+   1.16.0

docs/.eslintrc.yaml

@@ -0,0 +1,3 @@
+env:
+  browser: true
+  node: false

docs/CNAME

@@ -0,0 +1 @@
+mochajs.org

docs/README.md

@@ -0,0 +1,33 @@
+# mochajs.org
+
+*So you wanna build the site?*
+
+[mochajs.org](https://mochajs.org) is built using [Jekyll](http://jekyllrb.com), the popular static site generator.
+
+## Prerequisites
+
+- Ruby
+- RubyGems
+- Bundler (`gem install bundler`)
+- Node.js v4.0.0 or greater
+
+## Development
+
+1.  Run `npm install` to get Node.js deps.
+2.  Run `bundle install` to install Jekyll and its dependencies.  This may or may not require elevated privileges, depending on your system.
+3. To serve the site and rebuild as changes are made, execute `npm run serveDocs`.
+4. To rebuild the site *once*, execute `npm start buildDocs`.
+
+### Notes
+
+- The content lives in `docs/index.md`; everything else is markup, scripts, assets, etc.
+- `docs/index.md` may be mutated upon build.  If you update the table of contents, **you must commit `index.md`**; GitHub won't do it for you.
+- `docs/_site/` is where the generated static site lives (and is what you see at [mochajs.org](https://mochajs.org)).  It is *not* under version control.
+
+## License
+
+:copyright: 2016-2017 [JS Foundation](https://js.foundation) and contributors.
+
+Content licensed [CC-BY-4.0](https://raw.githubusercontent.com/mochajs/mocha/master/docs/LICENSE-CC-BY-4.0).
+
+Code licensed [MIT](https://raw.githubusercontent.com/mochajs/mocha/master/LICENSE-MIT).

docs/_config.yml

@@ -0,0 +1,8 @@
+url: https://mochajs.org
+exclude:
+  - README.md
+  - .*
+  - LICENSE*
+repository: mochajs/mocha
+source: docs
+

docs/_includes/backers.md

@@ -0,0 +1,6 @@
+## Backers
+
+Find Mocha helpful?  Become a [backer](https://opencollective.com/mochajs#support) and support Mocha with a monthly donation. 
+
+{: id="_backers" }
+{% for i in (0..29) %}[![](//opencollective.com/mochajs/backer/{{ i }}/avatar){: onload="window.avatars.backerLoaded()" }](https://opencollective.com/mochajs/backer/{{ i }}/website){: target="_blank"} {% endfor %}

docs/_includes/footer.html

@@ -0,0 +1,14 @@
+<footer>
+  <span>
+    <a href="https://mochajs.org">mochajs.org</a> is licensed under a <a rel="license"
+      href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.
+    <p><em>Last updated: {{ site.time | date: "%c" }}</em>
+  </span>
+  <script src="//cdnjs.cloudflare.com/ajax/libs/anchor-js/3.2.2/anchor.min.js"></script>
+  <script>
+    anchors.options = {
+      placement: 'left'
+    };
+    anchors.add('h2, h3');
+  </script>
+</footer>

docs/_includes/head.html

@@ -0,0 +1,14 @@
+<head>
+  <meta charset="utf-8">
+  <title>{{ page.title }}</title>
+  <link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/normalize/4.2.0/normalize.min.css"/>
+  <link rel="stylesheet" href="css/style.css"/>
+  <link rel="stylesheet" href="css/pygments.css"/>
+  <link rel="shortcut icon" href="favicon.ico"/>
+
+  <!--[if lt IE 9]>
+  <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.2/html5shiv.min.js"></script>
+  <![endif]-->
+  <script src="js/ga.js"></script>
+  <script src="js/avatars.js"></script>
+</head>

docs/_includes/header.html

@@ -0,0 +1,4 @@
+<header id="_header">
+  <h1><a href="/"><img onload="window.document.getElementById('_header').classList.add('onload');" src="//cldup.com/xFVFxOioAU.svg"></a></h1>
+  <p id="tag"><em>simple</em>, <em>flexible</em>, <em>fun</em></p>
+</header>

docs/_includes/sponsors.md

@@ -0,0 +1,6 @@
+## Sponsors
+
+Use Mocha at Work?  Ask your manager or marketing team if they'd help [support](https://opencollective.com/mochajs#support) our project.  Your company's logo will also be displayed on [npmjs.com](http://npmjs.com/package/mocha) and our [GitHub repository](https://github.com/mochajs/mocha#sponsors).
+
+{: id="_sponsors" }
+{% for i in (0..29) %}[![](//opencollective.com/mochajs/sponsor/{{ i }}/avatar){: onload="window.avatars.sponsorLoaded()" }](https://opencollective.com/mochajs/sponsor/{{ i }}/website){: target="_blank"} {% endfor %}

docs/_layouts/default.html

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="en">
+
+  {% include head.html %}
+
+  <body>
+
+    {% include header.html %}
+
+    <section id="content">
+      {{ content }}
+    </section>
+
+    {% include footer.html %}
+  </body>
+
+</html>

docs/css/pygments.css

@@ -0,0 +1,59 @@
+.highlight .hll { background-color: #ffffcc }
+.highlight .c { color: #999988; font-style: italic } /* Comment */
+.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
+.highlight .k { font-weight: bold } /* Keyword */
+.highlight .o { font-weight: bold } /* Operator */
+.highlight .cm { color: #999988; font-style: italic } /* Comment.Multiline */
+.highlight .cp { color: #999999; font-weight: bold } /* Comment.Preproc */
+.highlight .c1 { color: #999988; font-style: italic } /* Comment.Single */
+.highlight .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */
+.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
+.highlight .ge { font-style: italic } /* Generic.Emph */
+.highlight .gr { color: #aa0000 } /* Generic.Error */
+.highlight .gh { color: #999999 } /* Generic.Heading */
+.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
+.highlight .go { color: #888888 } /* Generic.Output */
+.highlight .gp { color: #555555 } /* Generic.Prompt */
+.highlight .gs { font-weight: bold } /* Generic.Strong */
+.highlight .gu { color: #aaaaaa } /* Generic.Subheading */
+.highlight .gt { color: #aa0000 } /* Generic.Traceback */
+.highlight .kc { font-weight: bold } /* Keyword.Constant */
+.highlight .kd { font-weight: bold } /* Keyword.Declaration */
+.highlight .kn { font-weight: bold } /* Keyword.Namespace */
+.highlight .kp { font-weight: bold } /* Keyword.Pseudo */
+.highlight .kr { font-weight: bold } /* Keyword.Reserved */
+.highlight .kt { color: #445588; font-weight: bold } /* Keyword.Type */
+.highlight .m { color: #009999 } /* Literal.Number */
+.highlight .s { color: #bb8844 } /* Literal.String */
+.highlight .na { color: #008080 } /* Name.Attribute */
+.highlight .nb { color: #999999 } /* Name.Builtin */
+.highlight .nc { color: #445588; font-weight: bold } /* Name.Class */
+.highlight .no { color: #008080 } /* Name.Constant */
+.highlight .ni { color: #800080 } /* Name.Entity */
+.highlight .ne { color: #990000; font-weight: bold } /* Name.Exception */
+.highlight .nf { color: #990000; font-weight: bold } /* Name.Function */
+.highlight .nn { color: #555555 } /* Name.Namespace */
+.highlight .nt { color: #000080 } /* Name.Tag */
+.highlight .nv { color: #008080 } /* Name.Variable */
+.highlight .ow { font-weight: bold } /* Operator.Word */
+.highlight .w { color: #bbbbbb } /* Text.Whitespace */
+.highlight .mf { color: #009999 } /* Literal.Number.Float */
+.highlight .mh { color: #009999 } /* Literal.Number.Hex */
+.highlight .mi { color: #009999 } /* Literal.Number.Integer */
+.highlight .mo { color: #009999 } /* Literal.Number.Oct */
+.highlight .sb { color: #bb8844 } /* Literal.String.Backtick */
+.highlight .sc { color: #bb8844 } /* Literal.String.Char */
+.highlight .sd { color: #bb8844 } /* Literal.String.Doc */
+.highlight .s2 { color: #bb8844 } /* Literal.String.Double */
+.highlight .se { color: #bb8844 } /* Literal.String.Escape */
+.highlight .sh { color: #bb8844 } /* Literal.String.Heredoc */
+.highlight .si { color: #bb8844 } /* Literal.String.Interpol */
+.highlight .sx { color: #bb8844 } /* Literal.String.Other */
+.highlight .sr { color: #808000 } /* Literal.String.Regex */
+.highlight .s1 { color: #bb8844 } /* Literal.String.Single */
+.highlight .ss { color: #bb8844 } /* Literal.String.Symbol */
+.highlight .bp { color: #999999 } /* Name.Builtin.Pseudo */
+.highlight .vc { color: #008080 } /* Name.Variable.Class */
+.highlight .vg { color: #008080 } /* Name.Variable.Global */
+.highlight .vi { color: #008080 } /* Name.Variable.Instance */
+.highlight .il { color: #009999 } /* Literal.Number.Integer.Long */