From 450ae964411f5180e4c3f7e6e974ccba03eb4e59 Mon Sep 17 00:00:00 2001
From: Orta <git@orta.io>
Date: Thu, 6 Aug 2020 09:16:36 -0400
Subject: [PATCH] Improe the JSX docs

---
 .../tsconfig-reference/copy/en/options/jsx.md | 56 ++++++++++++++++++-
 .../scripts/tsconfigRules.ts                  |  2 +-
 .../src/redirects/setupRedirects.ts           |  4 +-
 packages/typescriptlang-org/tsconfig.json     |  5 --
 4 files changed, 59 insertions(+), 8 deletions(-)

diff --git a/packages/tsconfig-reference/copy/en/options/jsx.md b/packages/tsconfig-reference/copy/en/options/jsx.md
index 4bc971449e77..543c9407ddd6 100644
--- a/packages/tsconfig-reference/copy/en/options/jsx.md
+++ b/packages/tsconfig-reference/copy/en/options/jsx.md
@@ -6,6 +6,60 @@ oneline: "Control how JSX is emitted"
 Controls how JSX constructs are emitted in JavaScript files.
 This only affects output of JS files that started in `.tsx` files.
 
-- `preserve`: Emit `.jsx` files with the JSX unchanged
 - `react`: Emit `.js` files with JSX changed to the equivalent `React.createElement` calls
+- `preserve`: Emit `.jsx` files with the JSX unchanged
 - `react-native`: Emit `.js` files with the JSX unchanged
+
+<!-- This is blocked on https://github.com/microsoft/TypeScript-Website/issues/860
+
+### For example
+
+This sample code:
+
+```ts
+export const helloWorld = () => <h1>Hello world</h1>;
+```
+
+Default: ("react")
+
+```tsx twoslash
+declare module JSX {
+  interface Element {}
+  interface IntrinsicElements {
+    [s: string]: any;
+  }
+}
+// @showEmit
+// @noErrors
+export const helloWorld = () => <h1>Hello world</h1>;
+```
+
+Preserve:
+
+```ts twoslash
+declare module JSX {
+  interface Element {}
+  interface IntrinsicElements {
+    [s: string]: any;
+  }
+}
+// @showEmit
+// @noErrors
+// @jsx: preserve
+export const helloWorld = () => <h1>Hello world</h1>;
+```
+
+React Native:
+
+````ts twoslash
+declare module JSX {
+  interface Element {}
+  interface IntrinsicElements {
+    [s: string]: any;
+  }
+}
+// @showEmit
+// @noErrors
+// @jsx: react-native
+export const helloWorld = () => <h1>Hello world</h1>;
+````
diff --git a/packages/tsconfig-reference/scripts/tsconfigRules.ts b/packages/tsconfig-reference/scripts/tsconfigRules.ts
index 2c732d07e228..521c9c21fc70 100644
--- a/packages/tsconfig-reference/scripts/tsconfigRules.ts
+++ b/packages/tsconfig-reference/scripts/tsconfigRules.ts
@@ -117,7 +117,7 @@ export const defaultsForOptions = {
   inlineSourceMap: "false",
   inlineSources: "false",
   isolatedModules: "false",
-  jsx: '`"preserve"`',
+  jsx: '`"react"`',
   jsxFactory: "`React.createElement`",
   keyofStringsOnly: "false",
   listEmittedFiles: "false",
diff --git a/packages/typescriptlang-org/src/redirects/setupRedirects.ts b/packages/typescriptlang-org/src/redirects/setupRedirects.ts
index ba541993a069..f1e6d5942724 100644
--- a/packages/typescriptlang-org/src/redirects/setupRedirects.ts
+++ b/packages/typescriptlang-org/src/redirects/setupRedirects.ts
@@ -31,7 +31,9 @@ export const setupRedirects = (
     const fromArray = Object.keys(obj)
     fromArray.forEach(from => {
       const to = obj[from]
-      console.log(`Making redirect from ${from} to ${to}`)
+      if (process.env.CI) {
+        console.log(`Making redirect from ${from} to ${to}`)
+      }
       createRedirect({
         isPermanent: true,
         redirectInBrowser: true,
diff --git a/packages/typescriptlang-org/tsconfig.json b/packages/typescriptlang-org/tsconfig.json
index e5dab08c671a..636824fe9e9e 100644
--- a/packages/typescriptlang-org/tsconfig.json
+++ b/packages/typescriptlang-org/tsconfig.json
@@ -4,13 +4,8 @@
     "target": "esnext",
     "module": "commonjs",
     "lib": ["dom", "es2017"],
-    // "allowJs": true,
-    // "checkJs": true,
-    "jsx": "react",
     "strict": true,
     "esModuleInterop": true,
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true,
     "noEmit": true,
     "skipLibCheck": true,
     "noImplicitAny": false,