add versioned documentation to the website (#5541)

* add versioned documentation to the website

* add changelog for versioned documentation

* exclude versioned docs from specific lint rules

* use id attribute instead of name for in page anchors and remove redundant anchors

* re-create docs for v22.3 with latest changes from master

.eslintrc.js

@@ -56,7 +56,10 @@ module.exports = {
  },
  },
  {
- excludedFiles: 'integration-tests/__tests__/**/*',
+ excludedFiles: [
+ 'integration-tests/__tests__/**/*',
+ 'website/versioned_docs/**/*.md',
+ ],
  files: [
  'examples/**/*',
  'scripts/**/*',

CHANGELOG.md

@@ -69,6 +69,8 @@
  ([#5523](https://github.com/facebook/jest/pull/5523))
 * `[jest-cli]` Support multiple glob patterns for `collectCoverageFrom`
  ([#5537](https://github.com/facebook/jest/pull/5537))
+* `[docs]` Add versioned documentation to the website
+ ([#5541](https://github.com/facebook/jest/pull/5541))
 
 ### Chore & Maintenance
 

website/package.json

@@ -7,7 +7,8 @@
  "build": "docusaurus-build",
  "gh-pages": "docusaurus-publish",
  "examples": "docusaurus-examples",
- "crowdin-upload": "crowdin --config ../crowdin.yaml upload sources --auto-update -b master",
+ "crowdin-upload":
+ "crowdin --config ../crowdin.yaml upload sources --auto-update -b master",
  "crowdin-download": "crowdin --config ../crowdin.yaml download -b master",
  "publish-gh-pages": "docusaurus-publish",
  "write-translations": "docusaurus-write-translations",

website/pages/en/versions.js

@@ -0,0 +1,104 @@
+/**
+ * Copyright (c) 2017-present, Facebook, Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+const React = require('react');
+
+const CompLibrary = require('../../core/CompLibrary');
+const Container = CompLibrary.Container;
+
+const CWD = process.cwd();
+
+const siteConfig = require(CWD + '/siteConfig.js');
+const versions = require(CWD + '/versions.json');
+
+class Versions extends React.Component {
+ render() {
+ const latestVersion = versions[0];
+ return (
+ <div className="docMainWrapper wrapper">
+ <Container className="mainContainer versionsContainer">
+ <div className="post">
+ <header className="postHeader">
+ <h2>{siteConfig.title + ' Versions'}</h2>
+ </header>
+ <h3 id="latest">Current version (Stable)</h3>
+ <p>Latest stable version of Jest</p>
+ <table className="versions">
+ <tbody>
+ <tr>
+ <th>{latestVersion}</th>
+ <td>
+ <a
+ href={`${siteConfig.baseUrl}docs/en/getting-started.html`}
+ >
+ Documentation
+ </a>
+ </td>
+ <td>
+ <a href="https://github.com/facebook/jest/blob/master/CHANGELOG.md">
+ Release Notes
+ </a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ <h3 id="rc">Latest version</h3>
+ <p>
+ Here you can find the latest unreleased documentation and code.
+ </p>
+ <table className="versions">
+ <tbody>
+ <tr>
+ <th>master</th>
+ <td>
+ <a
+ href={`${
+ siteConfig.baseUrl
+ }docs/en/next/getting-started.html`}
+ >
+ Documentation
+ </a>
+ </td>
+ <td>
+ <a href="https://github.com/facebook/jest">Source Code</a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ <h3 id="archive">Past Versions</h3>
+ <p>
+ Here you can find documentation for previous versions of Jest.
+ </p>
+ <table className="versions">
+ <tbody>
+ {versions.map(
+ version =>
+ version !== latestVersion && (
+ <tr key={version}>
+ <th>{version}</th>
+ <td>
+ <a
+ href={`${
+ siteConfig.baseUrl
+ }docs/en/${version}/getting-started.html`}
+ >
+ Documentation
+ </a>
+ </td>
+ </tr>
+ )
+ )}
+ </tbody>
+ </table>
+ </div>
+ </Container>
+ </div>
+ );
+ }
+}
+
+module.exports = Versions;