Merge pull request #5357 from selbekk/potpourri

Potpourri
facebook · Oct 11, 2018 · 8e5f065 · 8e5f065
2 parents f0047bf + 2e9bc28
commit 8e5f065
Show file tree

Hide file tree

Showing 45 changed files with 310 additions and 342 deletions.
diff --git a/docusaurus/docs/adding-a-css-modules-stylesheet.md b/docusaurus/docs/adding-a-css-modules-stylesheet.md
@@ -1,6 +1,7 @@
 ---
 id: adding-a-css-modules-stylesheet
-title: Adding a CSS Modules Stylesheet
+title: Adding A CSS Modules Stylesheet
+sidebar_label: Adding CSS Modules
 ---
 
 > Note: this feature is available with `[email protected]` and higher.

diff --git a/docusaurus/docs/adding-a-router.md b/docusaurus/docs/adding-a-router.md
@@ -1,6 +1,6 @@
 ---
 id: adding-a-router
-title: Adding a Router
+title: Adding A Router
 ---
 
 Create React App doesn't prescribe a specific routing solution, but [React Router](https://reacttraining.com/react-router/web/) is the most popular one.

diff --git a/docusaurus/docs/adding-a-sass-stylesheet.md b/docusaurus/docs/adding-a-sass-stylesheet.md
@@ -1,6 +1,7 @@
 ---
 id: adding-a-sass-stylesheet
-title: Adding a Sass Stylesheet
+title: Adding A Sass Stylesheet
+sidebar_label: Adding Sass Stylesheets
 ---
 
 > Note: this feature is available with `[email protected]` and higher.

diff --git a/docusaurus/docs/adding-a-stylesheet.md b/docusaurus/docs/adding-a-stylesheet.md
@@ -1,6 +1,7 @@
 ---
 id: adding-a-stylesheet
-title: Adding a Stylesheet
+title: Adding A Stylesheet
+sidebar_label: Adding Stylesheets
 ---
 
 This project setup uses [Webpack](https://webpack.js.org/) for handling all assets. Webpack offers a custom way of “extending” the concept of `import` beyond JavaScript. To express that a JavaScript file depends on a CSS file, you need to **import the CSS from the JavaScript file**:

diff --git a/docusaurus/docs/adding-custom-environment-variables.md b/docusaurus/docs/adding-custom-environment-variables.md
@@ -1,6 +1,7 @@
 ---
 id: adding-custom-environment-variables
 title: Adding Custom Environment Variables
+sidebar_label: Environment Variables
 ---
 > Note: this feature is available with `[email protected]` and higher.
 

diff --git a/docusaurus/docs/adding-images-fonts-and-files.md b/docusaurus/docs/adding-images-fonts-and-files.md
@@ -1,6 +1,6 @@
 ---
 id: adding-images-fonts-and-files
-title: Adding Images, Fonts, and Files
+title: Adding Images, Fonts, And Files
 ---
 
 With Webpack, using static assets like images and fonts works similarly to CSS.

diff --git a/docusaurus/docs/alternatives-to-ejecting.md b/docusaurus/docs/alternatives-to-ejecting.md
@@ -1,6 +1,6 @@
 ---
 id: alternatives-to-ejecting
-title: Alternatives to Ejecting
+title: Alternatives To Ejecting
 ---
 
 [Ejecting](/docs/available-scripts#npm-run-eject) lets you customize anything, but from that point on you have to maintain the configuration and scripts yourself. This can be daunting if you have many similar projects. In such cases instead of ejecting we recommend to _fork_ `react-scripts` and any other packages you need. [This article](https://auth0.com/blog/how-to-configure-create-react-app/) dives into how to do it in depth. You can find more discussion in [this issue](https://github.com/facebook/create-react-app/issues/682).
diff --git a/docusaurus/docs/analyzing-the-bundle-size.md b/docusaurus/docs/analyzing-the-bundle-size.md
@@ -1,7 +1,7 @@
 ---
 id: analyzing-the-bundle-size
 title: Analyzing the Bundle Size
-sidebar_label: Analyzing bundle size
+sidebar_label: Analyzing Bundle Size
 ---
 
 [Source map explorer](https://www.npmjs.com/package/source-map-explorer) analyzes

diff --git a/docusaurus/docs/available-scripts.md b/docusaurus/docs/available-scripts.md
@@ -1,7 +1,7 @@
 ---
 id: available-scripts
 title: Available Scripts
-sidebar_label: Available scripts
+sidebar_label: Available Scripts
 ---
 
 In the project directory, you can run:

diff --git a/docusaurus/docs/changing-the-page-title.md b/docusaurus/docs/changing-the-page-title.md
diff --git a/docusaurus/docs/debugging-in-the-editor.md b/docusaurus/docs/debugging-in-the-editor.md
diff --git a/docusaurus/docs/debugging-tests.md b/docusaurus/docs/debugging-tests.md
@@ -1,7 +1,7 @@
 ---
 id: debugging-tests
 title: Debugging Tests
-sidebar_label: Debugging tests
+sidebar_label: Debugging Tests
 ---
 
 There are various ways to setup a debugger for your Jest tests. We cover debugging in Chrome and [Visual Studio Code](https://code.visualstudio.com/).

diff --git a/docusaurus/docs/deployment.md b/docusaurus/docs/deployment.md
@@ -456,3 +456,6 @@ When asked about the project path, make sure to specify the `build` folder, for
 
 Note that in order to support routers that use HTML5 `pushState` API, you may want to rename the `index.html` in your build folder to `200.html` before deploying to Surge. This [ensures that every URL falls back to that file](https://surge.sh/help/adding-a-200-page-for-client-side-routing).
 
+## Publishing Components To npm
+
+Create React App doesn't provide any built-in functionality to publish a component to npm. If you're ready to extract a component from your project so other people can use it, we recommend moving it to a separate directory outside of your project and then using a tool like [nwb](https://github.com/insin/nwb#react-components-and-libraries) to prepare it for publishing.
diff --git a/docusaurus/docs/developing-components-in-isolation.md b/docusaurus/docs/developing-components-in-isolation.md
@@ -1,6 +1,6 @@
 ---
 id: developing-components-in-isolation
-title: Developing Components in Isolation
+title: Developing Components In Isolation
 ---
 
 Usually, in an app, you have a lot of UI components, and each of them has many different states.

diff --git a/docusaurus/docs/documentation-intro.md b/docusaurus/docs/documentation-intro.md
@@ -1,7 +1,15 @@
 ---
 id: documentation-intro
-title: Welcome to the Documentation
-sidebar_label: About the docs
+title: Welcome To The Documentation
+sidebar_label: About The Docs
 ---
 
 Please navigate via the table of content for finding what you are looking for.
+
+## Something Missing?
+
+If you have ideas for more “How To” recipes that should be on this page, [let us know](https://github.com/facebook/create-react-app/issues) or [contribute some!](https://github.com/facebook/create-react-app/edit/master/packages/react-scripts/template/README.md)
+
+## Feedback
+
+We are always open to [your feedback](https://github.com/facebook/create-react-app/issues).
diff --git a/docusaurus/docs/fetching-data-with-ajax-requests.md b/docusaurus/docs/fetching-data-with-ajax-requests.md
@@ -1,6 +1,7 @@
 ---
 id: fetching-data-with-ajax-requests
 title: Fetching Data with AJAX Requests
+sidebar_label: Fetching Data
 ---
 
 React doesn't prescribe a specific approach to data fetching, but people commonly use either a library like [axios](https://github.com/axios/axios) or the [`fetch()` API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) provided by the browser.

diff --git a/docusaurus/docs/folder-structure.md b/docusaurus/docs/folder-structure.md
@@ -1,6 +1,6 @@
 ---
 id: folder-structure
-title: Folder structure
+title: Folder Structure
 ---
 
 After creation, your project should look like this:

diff --git a/docusaurus/docs/formatting-code-automatically.md b/docusaurus/docs/formatting-code-automatically.md
diff --git a/docusaurus/docs/generating-dynamic-meta-tags-on-the-server.md b/docusaurus/docs/generating-dynamic-meta-tags-on-the-server.md
diff --git a/docusaurus/docs/getting-started.md b/docusaurus/docs/getting-started.md
@@ -1,10 +1,9 @@
 ---
 id: getting-started
-title: Getting started
-sidebar_label: Getting started
+title: Getting Started
 ---
 
-Create React App is an officially supported way to create single-page React 
+Create React App is an officially supported way to create single-page React
 applications. It offers a modern build setup with no configuration.
 
 ## Quick Start

diff --git a/docusaurus/docs/importing-a-component.md b/docusaurus/docs/importing-a-component.md
@@ -1,6 +1,6 @@
 ---
 id: importing-a-component
-title: Importing a Component
+title: Importing A Component
 ---
 
 This project setup supports ES6 modules thanks to Webpack.<br>

diff --git a/docusaurus/docs/injecting-data-from-the-server-into-the-page.md b/docusaurus/docs/injecting-data-from-the-server-into-the-page.md
diff --git a/docusaurus/docs/installing-a-dependency.md b/docusaurus/docs/installing-a-dependency.md
@@ -1,6 +1,6 @@
 ---
 id: installing-a-dependency
-title: Installing a Dependency
+title: Installing A Dependency
 ---
 
 The generated project includes React and ReactDOM as dependencies. It also includes a set of scripts used by Create React App as a development dependency. You may install other dependencies (for example, React Router) with `npm`:

diff --git a/docusaurus/docs/integrating-with-an-api-backend.md b/docusaurus/docs/integrating-with-an-api-backend.md
@@ -1,6 +1,7 @@
 ---
 id: integrating-with-an-api-backend
-title: Integrating with an API Backend
+title: Integrating With An API Backend
+sidebar_label: Integrating With An API
 ---
 
 These tutorials will help you to integrate your app with an API backend running on another port,

diff --git a/docusaurus/docs/lint-output-in-the-editor.md b/docusaurus/docs/lint-output-in-the-editor.md
diff --git a/docusaurus/docs/making-a-progressive-web-app.md b/docusaurus/docs/making-a-progressive-web-app.md
@@ -1,6 +1,6 @@
 ---
 id: making-a-progressive-web-app
-title: Making a Progressive Web App
+title: Making A Progressive Web App
 ---
 
 The production build has all the tools necessary to generate a first-class

diff --git a/docusaurus/docs/pre-rendering-into-static-html-files.md b/docusaurus/docs/pre-rendering-into-static-html-files.md
@@ -1,6 +1,7 @@
 ---
 id: pre-rendering-into-static-html-files
-title: Pre-Rendering into Static HTML Files
+title: Pre-Rendering Into Static HTML Files
+sidebar_label: Pre-Rendering Static HTML
 ---
 
 If you’re hosting your `build` with a static hosting provider you can use [react-snapshot](https://www.npmjs.com/package/react-snapshot) or [react-snap](https://github.com/stereobooster/react-snap) to generate HTML pages for each route, or relative link, in your application. These pages will then seamlessly become active, or “hydrated”, when the JavaScript bundle has loaded.

diff --git a/docusaurus/docs/proxying-api-requests-in-development.md b/docusaurus/docs/proxying-api-requests-in-development.md
@@ -1,7 +1,7 @@
 ---
 id: proxying-api-requests-in-development
-title: Proxying API Requests in Development
-sidebar_label: Proxying in development
+title: Proxying API Requests In Development
+sidebar_label: Proxying In Development
 ---
 
 > Note: this feature is available with `[email protected]` and higher.

diff --git a/docusaurus/docs/publishing-components-to-npm.md b/docusaurus/docs/publishing-components-to-npm.md
diff --git a/docusaurus/docs/running-tests.md b/docusaurus/docs/running-tests.md
@@ -1,7 +1,6 @@
 ---
 id: running-tests
 title: Running Tests
-sidebar_label: Running tests
 ---
 
 > Note: this feature is available with `[email protected]` and higher.<br>
Original file line number	Diff line number	Diff line change
Expand Up		@@ -456,3 +456,6 @@ When asked about the project path, make sure to specify the `build` folder, for

		Note that in order to support routers that use HTML5 `pushState` API, you may want to rename the `index.html` in your build folder to `200.html` before deploying to Surge. This [ensures that every URL falls back to that file](https://surge.sh/help/adding-a-200-page-for-client-side-routing).

		## Publishing Components To npm

		Create React App doesn't provide any built-in functionality to publish a component to npm. If you're ready to extract a component from your project so other people can use it, we recommend moving it to a separate directory outside of your project and then using a tool like [nwb](https://github.com/insin/nwb#react-components-and-libraries) to prepare it for publishing.