Merge branch 'master' into tipsi-stripe

facebook · May 16, 2019 · fd51a0c · fd51a0c
2 parents 6efd638 + 6767f8e
commit fd51a0c
Show file tree

Hide file tree

Showing 245 changed files with 4,735 additions and 6,984 deletions.
diff --git a/.eslintignore b/.eslintignore
@@ -9,3 +9,4 @@ website/
 scripts
 packages/docusaurus-1.x/lib/core/metadata.js
 packages/docusaurus-1.x/lib/core/MetadataBlog.js
+packages/docusaurus-1.x/lib/core/__tests__/split-tab.test.js
diff --git a/.eslintrc.js b/.eslintrc.js
@@ -25,7 +25,11 @@ module.exports = {
   rules: {
     'class-methods-use-this': OFF, // It's a way of allowing private variables.
     'func-names': OFF,
-    'import/no-unresolved': WARNING, // Because it couldn't resolve webpack alias.
+    // Ignore certain webpack alias because it can't be resolved
+    'import/no-unresolved': [
+      ERROR,
+      {ignore: ['^@theme', '^@docusaurus', '^@generated']},
+    ],
     'header/header': [
       ERROR,
       'block',
@@ -42,8 +46,8 @@ module.exports = {
         ' ',
       ],
     ],
-    'jsx-a11y/click-events-have-key-events': OFF, // Revisit in future™
-    'jsx-a11y/no-noninteractive-element-interactions': OFF, // Revisit in future™
+    'jsx-a11y/click-events-have-key-events': WARNING,
+    'jsx-a11y/no-noninteractive-element-interactions': WARNING,
     'no-console': OFF,
     'no-underscore-dangle': OFF,
     'react/jsx-closing-bracket-location': OFF, // Conflicts with Prettier.

diff --git a/.gitignore b/.gitignore
@@ -11,3 +11,4 @@ yarn-error.log
 build
 .docusaurus
 .cache-loader
+
diff --git a/.prettierignore b/.prettierignore
@@ -1,4 +1,4 @@
 dist
 node_modules
 build
-.docusaurus
+.docusaurus
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1070,7 +1070,7 @@ N/A
   - Blog
   - Documentation
 
-[unreleased]: https://github.com/facebook/Docusaurus/compare/v1.8.0...HEAD
+[unreleased]: https://github.com/facebook/Docusaurus/compare/v1.9.0...HEAD
 [1.9.0]: https://github.com/facebook/Docusaurus/compare/v1.8.1...v1.9.0
 [1.8.1]: https://github.com/facebook/Docusaurus/compare/v1.8.0...v1.8.1
 [1.8.0]: https://github.com/facebook/Docusaurus/compare/v1.7.3...v1.8.0

diff --git a/README.md b/README.md
@@ -31,7 +31,7 @@ We have also released the [`docusaurus-init` package](https://www.npmjs.com/pack
 
 ## Contributing
 
-We've released Docusaurus because it helps us better scale and support the many OSS projects at Facebook. We hope that other organizations can benefit from the project. We are thankful for any contributions from the community.
+We've released Docusaurus because it helps us better scale and supports the many OSS projects at Facebook. We hope that other organizations can benefit from the project. We are thankful for any contributions from the community.
 
 ### [Code of Conduct](https://code.fb.com/codeofconduct)
 

diff --git a/babel.config.js b/babel.config.js
@@ -6,7 +6,17 @@
  */
 
 module.exports = {
-  presets: ['@babel/env', '@babel/react'],
+  presets: [
+    [
+      '@babel/env',
+      {
+        targets: {
+          node: 'current',
+        },
+      },
+    ],
+    '@babel/react',
+  ],
   plugins: [
     '@babel/plugin-proposal-class-properties',
     '@babel/plugin-proposal-object-rest-spread',

diff --git a/docs/api-site-config.md b/docs/api-site-config.md
@@ -128,7 +128,7 @@ The default version for the site to be shown. If this is not set, the latest ver
 
 #### `docsUrl` [string]
 
-The base url for all docs file. Set this field to `''` to remove the `docs` prefix of the documentation URL. 
+The base url for all docs file. Set this field to `''` to remove the `docs` prefix of the documentation URL.
 If unset, it is defaulted to `docs`.
 
 #### `disableHeaderTitle` [boolean]
@@ -247,6 +247,10 @@ Hostname of your server. Useful if you are using GitHub Enterprise.
 
 Path to your web app manifest (e.g., `manifest.json`). This will add a `<link>` tag to `<head>` with `rel` as `"manifest"` and `href` as the provided path.
 
+#### `markdownOptions` [object]
+
+Override default [Remarkable options](https://github.com/jonschlinkert/remarkable#options) that will be used to render markdown.
+
 #### `markdownPlugins` [array]
 
 An array of plugins to be loaded by Remarkable, the markdown parser and renderer used by Docusaurus. The plugin will receive a reference to the Remarkable instance, allowing custom parsing and rendering rules to be defined.

diff --git a/docs/tutorial-create-pages.md b/docs/tutorial-create-pages.md
@@ -34,11 +34,11 @@ module.exports = HelloWorld;
 ```
 
 2. Go to http://localhost:3000/hello-world and you should be able to see the new page.
-1. Change the text within the `<p>...</p>` to "I'm at F8!". The browser should refresh automatically to reflect the changes.
+1. Change the text within the `<p>...</p>` to "I can write JSX here!". The browser should refresh automatically to reflect the changes.
 
 ```diff
 - <p>This is my first page!</p>
-+ <p>I'm at F8!</p>
++ <p>I can write JSX here!</p>
 ```
 
 React is being used as a templating engine for rendering static markup. You can leverage on the expressability of React to build rich web content. Learn more about creating pages [here](custom-pages).
@@ -47,30 +47,37 @@ React is being used as a templating engine for rendering static markup. You can
 
 ## Create a Documentation Page
 
-1. Create a new file in the `docs` folder called `f8.md`.
+1. Create a new file in the `docs` folder called `doc4.md`.
 1. Paste the following contents:
 
 ```
 ---
-id: f8
-title: Hello F8
+id: doc4
+title: This is Doc 4
 ---
 
-Hello F8! I'm at the Docusaurus classroom session!
+I can write content using [GitHub-flavored Markdown syntax](https://github.github.com/gfm/).
 
-## Using Docusaurus to Create Open Source Websites
+## Markdown Syntax
 
-In this session, we learned how Docusaurus makes it really simple to create a website for open source project documentation and get hands on by creating a Docusaurus website.
+**Bold** _italic_ `code` [Links](#url)
+
+> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
+> id sem consectetuer libero luctus adipiscing.
+
+* Hey
+* Ho
+* Let's Go
 ```
 
-3. Go to `sidebars.json` and add `"f8"` after `"doc1"`. This ID should be the same one as in the Markdown file above.
+3. Go to `sidebars.json` and add `"doc4"` after `"doc1"`. This ID should be the same one as in the Markdown file above.
 
 ```diff
 {
   "docs": {
     "Docusaurus": [
       "doc1",
-+     "f8"
++     "doc4"
     ],
     "First Category": ["doc2"],
     "Second Category": ["doc3"]
@@ -82,7 +89,7 @@ In this session, we learned how Docusaurus makes it really simple to create a we
 ```
 
 4. Kill your webserver (<kbd>Cmd</kbd> + <kbd>C</kbd> or <kbd>Ctrl</kbd> + <kbd>C</kbd>) and restart it (with `npm run start`) because a server restart is needed for sidebar changes.
-5. Navigate to http://localhost:3000/docs/f8.
+5. Navigate to http://localhost:3000/docs/doc4.
 
 You've created your first documentation page on Docusaurus! The `sidebars.json` is where you specify the order of your documentation pages and in the front matter of the Markdown file is where you provide metadata about that page.
 

diff --git a/jest.config.js b/jest.config.js
@@ -12,11 +12,8 @@ module.exports = {
   verbose: true,
   testURL: 'http://localhost/',
   testEnvironment: 'node',
-  moduleNameMapper: {
-    '^@lib/(.*)$': '<rootDir>/packages/docusaurus/lib/$1',
-  },
   testPathIgnorePatterns: ['/node_modules/', '__fixtures__'],
   transform: {
-    '^.+\\.js$': '<rootDir>/jest.transform.js',
+    '^.+\\.js$': 'babel-jest',
   },
 };
diff --git a/lerna.json b/lerna.json
@@ -1,6 +1,6 @@
 {
-  "lerna": "3.13.1",
-  "version": "2.0.0-alpha.12",
+  "lerna": "3.14.1",
+  "version": "2.0.0-alpha.16",
   "npmClient": "yarn",
   "useWorkspaces": true
 }
diff --git a/package.json b/package.json
@@ -13,8 +13,10 @@
     "test": "jest"
   },
   "devDependencies": {
-    "babel-core": "^7.0.0-0",
+    "@babel/core": "^7.4.4",
     "babel-eslint": "8",
+    "enzyme": "^3.9.0",
+    "enzyme-adapter-react-16": "^1.12.1",
     "eslint": "4.x",
     "eslint-config-airbnb": "17.1.0",
     "eslint-config-prettier": "^2.9.0",
@@ -27,13 +29,13 @@
     "front-matter": "^2.3.0",
     "glob-promise": "^3.3.0",
     "husky": "^1.3.1",
-    "jest": "^24.1.0",
-    "lerna": "^3.13.1",
+    "jest": "^24.6.0",
+    "lerna": "^3.14.1",
     "lint-staged": "^7.2.0",
     "prettier": "^1.13.7",
     "react": "^16.8.4",
     "react-dom": "^16.8.4",
-    "rimraf": "^2.6.2"
+    "rimraf": "^2.6.3"
   },
   "lint-staged": {
     "linters": {