move everything into docs/ in prep for moving repo into mocha proper

- some jekyll tweaks were needed; we can no longer consume the `github-pages` gem apparently since they added support for themes - added `markdown-toc` dev dep to build the toc - added `buildDocs` and `serveDocs` scripts - miraculously avoided monkeying with the content itself Signed-off-by: Christopher Hiller <[email protected]>
mochajs · Dec 6, 2017 · c247032 · c247032
1 parent 5752458
commit c247032
Show file tree

Hide file tree

Showing 54 changed files with 117 additions and 6,065 deletions.
diff --git a/.editorconfig b/.editorconfig
diff --git a/.gitignore b/.gitignore
diff --git a/Gemfile b/Gemfile
diff --git a/LICENSE-MIT b/LICENSE-MIT
diff --git a/README.md b/README.md
diff --git a/_config.yml b/_config.yml
diff --git a/docs/.eslintrc.yaml b/docs/.eslintrc.yaml
@@ -0,0 +1,3 @@
+env:
+  browser: true
+  node: false
diff --git a/CNAME → docs/CNAME b/CNAME → docs/CNAME
diff --git a/LICENSE-CC-BY-4.0 → docs/LICENSE-CC-BY-4.0 b/LICENSE-CC-BY-4.0 → docs/LICENSE-CC-BY-4.0
diff --git a/docs/README.md b/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).
diff --git a/docs/_config.yml b/docs/_config.yml
@@ -0,0 +1,8 @@
+url: https://mochajs.org
+exclude:
+  - README.md
+  - .*
+  - LICENSE*
+repository: mochajs/mocha
+source: docs
+
diff --git a/_includes/backers.md → docs/_includes/backers.md b/_includes/backers.md → docs/_includes/backers.md
diff --git a/_includes/footer.html → docs/_includes/footer.html b/_includes/footer.html → docs/_includes/footer.html
diff --git a/_includes/head.html → docs/_includes/head.html b/_includes/head.html → docs/_includes/head.html
diff --git a/_includes/header.html → docs/_includes/header.html b/_includes/header.html → docs/_includes/header.html
diff --git a/_includes/sponsors.md → docs/_includes/sponsors.md b/_includes/sponsors.md → docs/_includes/sponsors.md
diff --git a/_layouts/default.html → docs/_layouts/default.html b/_layouts/default.html → docs/_layouts/default.html
diff --git a/css/pygments.css → docs/css/pygments.css b/css/pygments.css → docs/css/pygments.css
diff --git a/css/style.css → docs/css/style.css b/css/style.css → docs/css/style.css
diff --git a/example/Array.js → docs/example/Array.js b/example/Array.js → docs/example/Array.js
diff --git a/docs/example/async-dump.js b/docs/example/async-dump.js
@@ -0,0 +1,33 @@
+'use strict';
+
+const {createHook} = require('async_hooks');
+const {stackTraceFilter} = require('mocha/lib/utils');
+const allResources = new Map();
+const resourceActivity = new Set();
+
+const filterStack = stackTraceFilter();
+
+const hook = createHook({
+  init(asyncId, type, triggerAsyncId) {
+    allResources.set(asyncId, {type, triggerAsyncId, stack: (new Error()).stack});
+  },
+  before(asyncId) {
+    resourceActivity.add(asyncId);
+  },
+  after(asyncId) {
+    resourceActivity.delete(asyncId);
+  },
+  destroy(asyncId) {
+    allResources.delete(asyncId);
+  }
+}).enable();
+
+global.asyncDump = module.exports = () => {
+  hook.disable();
+  console.error('STUFF STILL IN THE EVENT LOOP:')
+  allResources.forEach(value=> {
+    console.error(`Type: ${value.type}`);
+    console.error(filterStack(value.stack));
+    console.error('\n');
+  });
+};
diff --git a/example/chai.js → docs/example/chai.js b/example/chai.js → docs/example/chai.js
diff --git a/docs/example/debug-hanging-mocha.js b/docs/example/debug-hanging-mocha.js
@@ -0,0 +1,22 @@
+'use strict';
+
+const net = require('net');
+const assert = require('assert');
+
+describe('how to debug Mocha when it hangs', function () {
+  before(function (done) {
+    const server = net.createServer();
+    server.listen(10101, done);
+  });
+
+  after(function () {
+    global.asyncDump();
+  });
+
+  it('should complete, but Mocha should not exit', function(done) {
+    const sock = net.createConnection(10101, () => {
+      assert.deepEqual(sock.address().family, 'IPv4');
+      done();
+    });
+  });
+});
diff --git a/example/tests.html → docs/example/tests.html b/example/tests.html → docs/example/tests.html
@@ -3,13 +3,13 @@
   <head>
     <meta charset="utf-8">
     <title>Mocha</title>
-    <link rel="stylesheet" href="mocha.css">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/mocha/4.0.1/mocha.min.css">
     <link rel="shortcut icon" href="../favicon.ico">
   </head>
   <body>
     <div id="mocha"></div>
-    <script src="mocha.js"></script>
-    <script src="chai.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/mocha/4.0.1/mocha.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/chai/4.1.2/chai.min.js"></script>
     <script>mocha.setup('bdd')</script>
     <script>expect = chai.expect</script>
     <script src="Array.js"></script>

diff --git a/favicon.ico → docs/favicon.ico b/favicon.ico → docs/favicon.ico
diff --git a/images/emacs.png → docs/images/emacs.png b/images/emacs.png → docs/images/emacs.png
diff --git a/images/jetbrains-plugin.png → docs/images/jetbrains-plugin.png b/images/jetbrains-plugin.png → docs/images/jetbrains-plugin.png
diff --git a/images/reporter-doc.png → docs/images/reporter-doc.png b/images/reporter-doc.png → docs/images/reporter-doc.png
diff --git a/images/reporter-dot.png → docs/images/reporter-dot.png b/images/reporter-dot.png → docs/images/reporter-dot.png
diff --git a/images/reporter-html.png → docs/images/reporter-html.png b/images/reporter-html.png → docs/images/reporter-html.png
diff --git a/images/reporter-json-stream.png → docs/images/reporter-json-stream.png b/images/reporter-json-stream.png → docs/images/reporter-json-stream.png
diff --git a/images/reporter-json.png → docs/images/reporter-json.png b/images/reporter-json.png → docs/images/reporter-json.png
diff --git a/images/reporter-landing-fail.png → docs/images/reporter-landing-fail.png b/images/reporter-landing-fail.png → docs/images/reporter-landing-fail.png
diff --git a/images/reporter-landing.png → docs/images/reporter-landing.png b/images/reporter-landing.png → docs/images/reporter-landing.png
diff --git a/images/reporter-list.png → docs/images/reporter-list.png b/images/reporter-list.png → docs/images/reporter-list.png
diff --git a/images/reporter-min.png → docs/images/reporter-min.png b/images/reporter-min.png → docs/images/reporter-min.png
diff --git a/images/reporter-nyan.png → docs/images/reporter-nyan.png b/images/reporter-nyan.png → docs/images/reporter-nyan.png
diff --git a/images/reporter-progress.png → docs/images/reporter-progress.png b/images/reporter-progress.png → docs/images/reporter-progress.png
diff --git a/images/reporter-spec-duration.png → docs/images/reporter-spec-duration.png b/images/reporter-spec-duration.png → docs/images/reporter-spec-duration.png
diff --git a/images/reporter-spec-fail.png → docs/images/reporter-spec-fail.png b/images/reporter-spec-fail.png → docs/images/reporter-spec-fail.png
diff --git a/images/reporter-spec.png → docs/images/reporter-spec.png b/images/reporter-spec.png → docs/images/reporter-spec.png
diff --git a/images/reporter-string-diffs.png → docs/images/reporter-string-diffs.png b/images/reporter-string-diffs.png → docs/images/reporter-string-diffs.png
diff --git a/images/reporter-tap.png → docs/images/reporter-tap.png b/images/reporter-tap.png → docs/images/reporter-tap.png
diff --git a/images/wallaby.png → docs/images/wallaby.png b/images/wallaby.png → docs/images/wallaby.png
diff --git a/index.md → docs/index.md b/index.md → docs/index.md
diff --git a/docs/js/avatars.js b/docs/js/avatars.js
@@ -0,0 +1,15 @@
+(function () {
+  'use strict';
+  // dumb thing that helps with animation of avatars
+  var avatars = window.avatars = function (type) {
+    return function avatarLoaded () {
+      avatars[type] = typeof avatars[type] === 'number' ? avatars[type] + 1 : 1;
+      if (avatars[type] === 30) {
+        document.getElementById(type).classList.add('onload');
+      }
+    };
+  };
+
+  avatars.backerLoaded = avatars('_backers');
+  avatars.sponsorLoaded = avatars('_sponsors');
+}());
diff --git a/js/ga.js → docs/js/ga.js b/js/ga.js → docs/js/ga.js