Move docs to docs/current

Reviewed By: jstejada

Differential Revision: D26901545

fbshipit-source-id: 6090a25422215434472a96684c096d4cd22c776c

website-v2/docs/api-reference/entrypoint-apis/entrypoint-container.md → website-v2/docs/current/api-reference/entrypoint-apis/entrypoint-container.md

@@ -4,7 +4,7 @@ title: EntryPointContainer
 slug: /api-reference/entrypoint-container/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 
 ## `EntryPointContainer`

website-v2/docs/api-reference/entrypoint-apis/load-entrypoint.md → website-v2/docs/current/api-reference/entrypoint-apis/load-entrypoint.md

@@ -4,7 +4,7 @@ title: loadEntryPoint
 slug: /api-reference/load-entrypoint/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 
 ## `loadEntryPoint`

website-v2/docs/api-reference/entrypoint-apis/use-entrypoint-loader.md → website-v2/docs/current/api-reference/entrypoint-apis/use-entrypoint-loader.md

@@ -4,7 +4,7 @@ title: useEntryPointLoader
 slug: /api-reference/use-entrypoint-loader/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 
 ## `useEntryPointLoader`

website-v2/docs/api-reference/graphql/graphql-directives.md → website-v2/docs/current/api-reference/graphql/graphql-directives.md

@@ -4,7 +4,7 @@ title: GraphQL Directives
 slug: /api-reference/graphql-and-directives/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {FbInternalOnly, OssOnly} from 'internaldocs-fb-helpers';
 
 Relay uses directives to add additional information to GraphQL documents, which are used by the [Relay compiler](../../guides/compiler/) to generate the appropriate runtime artifacts. These directives only appear in your application code and are removed from requests sent to your GraphQL server.

website-v2/docs/api-reference/hooks/load-query.md → website-v2/docs/current/api-reference/hooks/load-query.md

@@ -4,7 +4,7 @@ title: loadQuery
 slug: /api-reference/load-query/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 
 ## `loadQuery`

website-v2/docs/api-reference/hooks/relay-environment-provider.md → website-v2/docs/current/api-reference/hooks/relay-environment-provider.md

@@ -4,7 +4,7 @@ title: RelayEnvironmentProvider
 slug: /api-reference/relay-environment-provider/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 
 ## `RelayEnvironmentProvider`
 

website-v2/docs/api-reference/hooks/use-fragment.md → website-v2/docs/current/api-reference/hooks/use-fragment.md

@@ -4,7 +4,7 @@ title: useFragment
 slug: /api-reference/use-fragment/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 
 ## `useFragment`
 

website-v2/docs/api-reference/hooks/use-lazy-load-query.md → website-v2/docs/current/api-reference/hooks/use-lazy-load-query.md

@@ -4,7 +4,7 @@ title: useLazyLoadQuery
 slug: /api-reference/use-lazy-load-query/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 
 ## `useLazyLoadQuery`
 

website-v2/docs/api-reference/hooks/use-mutation.md → website-v2/docs/current/api-reference/hooks/use-mutation.md

@@ -4,7 +4,7 @@ title: useMutation
 slug: /api-reference/use-mutation/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 import FbUseMutationParameter from './fb/FbUseMutationParameter.md';
 

website-v2/docs/api-reference/hooks/use-pagination-fragment.md → website-v2/docs/current/api-reference/hooks/use-pagination-fragment.md

@@ -4,7 +4,7 @@ title: usePaginationFragment
 slug: /api-reference/use-pagination-fragment/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 import FbUsePaginationFragmentReturnValue from './fb/FbUsePaginationFragmentReturnValue.md';
 

website-v2/docs/api-reference/hooks/use-preloaded-query.md → website-v2/docs/current/api-reference/hooks/use-preloaded-query.md

@@ -4,7 +4,7 @@ title: usePreloadedQuery
 slug: /api-reference/use-preloaded-query/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 
 ## `usePreloadedQuery`
 

website-v2/docs/api-reference/hooks/use-query-loader.md → website-v2/docs/current/api-reference/hooks/use-query-loader.md

@@ -4,7 +4,7 @@ title: useQueryLoader
 slug: /api-reference/use-query-loader/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 
 ## `useQueryLoader`
 

website-v2/docs/api-reference/hooks/use-refetchable-fragment.md → website-v2/docs/current/api-reference/hooks/use-refetchable-fragment.md

@@ -4,7 +4,7 @@ title: useRefetchableFragment
 slug: /api-reference/use-refetchable-fragment/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {FbInternalOnly, OssOnly} from 'internaldocs-fb-helpers';
 import FbUseRefetchableFragmentApiReferenceCodeExample from './fb/FbUseRefetchableFragmentApiReferenceCodeExample.md';
 import FbUseRefetchableFragmentReturnValue from './fb/FbUseRefetchableFragmentReturnValue.md';

website-v2/docs/api-reference/hooks/use-relay-environment.md → website-v2/docs/current/api-reference/hooks/use-relay-environment.md

@@ -4,7 +4,7 @@ title: useRelayEnvironment
 slug: /api-reference/use-relay-environment/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 
 ## `useRelayEnvironment`
 

website-v2/docs/api-reference/hooks/use-subscription.md → website-v2/docs/current/api-reference/hooks/use-subscription.md

@@ -4,7 +4,7 @@ title: useSubscription
 slug: /api-reference/use-subscription/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 import GraphQLSubscriptionConfig from '../types/GraphQLSubscriptionConfig.md';
 

website-v2/docs/api-reference/relay-runtime/commit-mutation.md → website-v2/docs/current/api-reference/relay-runtime/commit-mutation.md

@@ -4,7 +4,7 @@ title: commitMutation
 slug: /api-reference/commit-mutation/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 import MutationConfig from '../types/MutationConfig.md';
 import Disposable from '../types/Disposable.md';

website-v2/docs/api-reference/relay-runtime/fetch-query.md → website-v2/docs/current/api-reference/relay-runtime/fetch-query.md

@@ -4,7 +4,7 @@ title: fetchQuery
 slug: /api-reference/fetch-query/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 
 ## `fetchQuery`

website-v2/docs/api-reference/relay-runtime/request-subscription.md → website-v2/docs/current/api-reference/relay-runtime/request-subscription.md

@@ -4,7 +4,7 @@ title: requestSubscription
 slug: /api-reference/request-subscription/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 import GraphQLSubscriptionConfig from '../types/GraphQLSubscriptionConfig.md';
 import Disposable from '../types/Disposable.md';

website-v2/docs/api-reference/relay-runtime/store.md → website-v2/docs/current/api-reference/relay-runtime/store.md

@@ -4,7 +4,7 @@ title: RelayModernStore
 slug: /api-reference/store/
 ---
 
-import DocsRating from '../../../src/core/DocsRating';
+import DocsRating from '../../../../src/core/DocsRating';
 import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
 
 The Relay Store can be used to programmatically update client-side data inside [`updater` functions](../../guided-tour/updating-data/graphql-mutations/). The following is a reference of the Relay Store interface.

website-v2/docs/community/learning-resources.md → website-v2/docs/current/community/learning-resources.md

@@ -5,7 +5,7 @@ slug: /community-learning-resources/
 ---
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
-import DocsRating from '../../src/core/DocsRating';
+import DocsRating from '../../../src/core/DocsRating';
 
 ## Relay example projects
 

website-v2/docs/debugging/inconsistent-typename-error.md → website-v2/docs/current/debugging/inconsistent-typename-error.md

@@ -4,7 +4,7 @@ title: Inconsistent Typename Error
 slug: /debugging/inconsistent-typename-error/
 ---
 
-import DocsRating from '../../src/core/DocsRating';
+import DocsRating from '../../../src/core/DocsRating';
 import {FbInternalOnly, OssOnly} from 'internaldocs-fb-helpers';
 
 # Inconsistent __typename error

website-v2/docs/debugging/relay-devtools.md → website-v2/docs/current/debugging/relay-devtools.md

@@ -4,7 +4,7 @@ title: Relay DevTools
 slug: /debugging/relay-devtools/
 ---
 
-import DocsRating from '../../src/core/DocsRating';
+import DocsRating from '../../../src/core/DocsRating';
 import {FbInternalOnly, OssOnly} from 'internaldocs-fb-helpers';
 
 ## Installation

website-v2/docs/current/getting-started/installation-and-setup.md

@@ -0,0 +1,153 @@
+---
+id: installation-and-setup
+title: Installation and Setup
+slug: /getting-started/installation-and-setup/
+---
+
+import DocsRating from '../../../src/core/DocsRating';
+import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
+
+
+## Installation
+
+Install React and Relay using `yarn` or `npm`:
+
+```sh
+yarn add react react-dom react-relay
+```
+
+## Set up Relay with a single config file
+
+The below configuration of `babel-plugin-relay` and `relay-compiler` can be applied using a single configuration file by
+using the `relay-config` package. Besides unifying all Relay configuration in a single place, other tooling can leverage
+this to provide zero-config setup (e.g. [vscode-apollo-relay](https://github.com/relay-tools/vscode-apollo-relay)).
+
+Install the package:
+
+```sh
+yarn add --dev relay-config
+```
+
+And create the configuration file:
+
+```javascript
+// relay.config.js
+module.exports = {
+  // ...
+  // Configuration options accepted by the `relay-compiler` command-line tool and `babel-plugin-relay`.
+  src: "./src",
+  schema: "./data/schema.graphql",
+  exclude: ["**/node_modules/**", "**/__mocks__/**", "**/__generated__/**"],
+}
+```
+
+## Set up babel-plugin-relay
+
+Relay Modern requires a Babel plugin to convert GraphQL to runtime artifacts:
+
+```sh
+yarn add --dev babel-plugin-relay graphql
+```
+
+Add `"relay"` to the list of plugins your `.babelrc` file:
+
+```javascript
+{
+  "plugins": [
+    "relay"
+  ]
+}
+```
+
+Please note that the `"relay"` plugin should run before other plugins or
+presets to ensure the `graphql` template literals are correctly transformed. See
+Babel's [documentation on this topic](https://babeljs.io/docs/plugins/#pluginpreset-ordering).
+
+Alternatively, instead of using `babel-plugin-relay`, you can use Relay with [babel-plugin-macros](https://github.com/kentcdodds/babel-plugin-macros). After installing `babel-plugin-macros` and adding it to your Babel config:
+
+```javascript
+const graphql = require('babel-plugin-relay/macro');
+```
+
+If you need to configure `babel-plugin-relay` further (e.g. to enable `compat` mode), you can do so by [specifying the options in a number of ways](https://github.com/kentcdodds/babel-plugin-macros/blob/master/other/docs/user.md#config-experimental).
+
+For example:
+
+```javascript
+// babel-plugin-macros.config.js
+module.exports = {
+  // ...
+  // Other macros config
+  relay: {
+    compat: true,
+  },
+}
+```
+
+## Set up relay-compiler
+
+Relay's ahead-of-time compilation requires the [Relay Compiler](../../guides/compiler/), which you can install via `yarn` or `npm`:
+
+```sh
+yarn add --dev relay-compiler
+```
+
+This installs the bin script `relay-compiler` in your node_modules folder. It's recommended to run this from a `yarn`/`npm` script by adding a script to your `package.json` file:
+
+```js
+"scripts": {
+  "relay": "relay-compiler --src ./src --schema ./schema.graphql"
+}
+```
+
+or if you are using jsx:
+
+```js
+"scripts": {
+  "relay": "relay-compiler --src ./src --schema ./schema.graphql --extensions js jsx"
+}
+```
+
+Then, after making edits to your application files, just run the `relay` script to generate new compiled artifacts:
+
+```sh
+yarn run relay
+```
+
+Alternatively, you can pass the `--watch` option to watch for file changes in your source code and automatically re-generate the compiled artifacts (**Note:** Requires [watchman](https://facebook.github.io/watchman) to be installed):
+
+```sh
+yarn run relay --watch
+```
+
+For more details, check out our [Relay Compiler docs](../../guides/compiler/).
+
+## JavaScript environment requirements
+
+The Relay Modern packages distributed on NPM use the widely-supported ES5
+version of JavaScript to support as many browser environments as possible.
+
+However, Relay Modern expects modern JavaScript global types (`Map`, `Set`,
+`Promise`, `Object.assign`) to be defined. If you support older browsers and
+devices which may not yet provide these natively, consider including a global
+polyfill in your bundled application, such as [core-js][] or
+[@babel/polyfill](https://babeljs.io/docs/usage/polyfill/).
+
+A polyfilled environment for Relay using [core-js][] to support older browsers
+might look like:
+
+```js
+
+require('core-js/es6/map');
+require('core-js/es6/set');
+require('core-js/es6/promise');
+require('core-js/es6/object');
+
+require('./myRelayApplication');
+
+```
+
+[core-js]: https://github.com/zloirock/core-js
+
+
+<DocsRating />

website-v2/docs/current/getting-started/introduction.md

@@ -0,0 +1,32 @@
+---
+id: introduction
+title: Introduction to Relay
+slug: /
+---
+
+import DocsRating from '../../../src/core/DocsRating';
+import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers';
+
+Relay is a JavaScript framework for fetching and managing GraphQL data in React applications that emphasizes maintainability, type safety and runtime performance.
+
+Relay achieves this by combining declarative data fetching and a static build step. With declarative data fetching, components declare what data they need, and Relay figures out how to efficiently fetch it. During the static build step, Relay validates and optimizes queries, and pre-computes artifacts to achieve faster runtime performance.
+
+To get started, check out the following resources:
+
+<OssOnly>
+
+- A **[step-by-step guide](./getting-started/step-by-step-guide/)** to cover the very basics and quickly get up and running.
+- An overview of the **[prerequisites](./getting-started/prerequisites/)** for using Relay, and an **[installation and setup guide](./getting-started/installation-and-setup/)**.
+- The **[guided tour](./guided-tour/)**, for a comprehensive overview of Relay's different APIs and concepts, and usage examples for different use cases.
+- The **[API reference](./api-reference/relay-environment-provider/)**, for a reference of our APIs including a detailed overview of their inputs and outputs.
+
+</OssOnly>
+
+<FbInternalOnly>
+
+- The **[guided tour](./guided-tour/)**, for a comprehensive overview of Relay's different APIs and concepts, and usage examples for different use cases.
+- The **[API reference](./api-reference/relay-environment-provider/)**, for a reference of our APIs including a detailed overview of their inputs and outputs.
+
+</FbInternalOnly>
+
+<DocsRating />