From 6b977db6f37f70879c9f4ad5753261db059e4cd8 Mon Sep 17 00:00:00 2001 From: Jan Kassens Date: Wed, 31 Mar 2021 15:53:54 -0700 Subject: [PATCH] Docs: update more graphql.github.io links (#3435) Summary: These were all redirects losing the anchor part of the URL in the redirect. Pull Request resolved: https://github.com/facebook/relay/pull/3435 Reviewed By: jstejada Differential Revision: D27481297 Pulled By: kassens fbshipit-source-id: fa00de73d151b6b0349d0ad697f879e1b1e4f354 --- packages/relay-runtime/network/RelayNetworkTypes.js | 2 +- website/docs/glossary/glossary.md | 4 ++-- website/docs/guided-tour/list-data/connections.md | 4 ++-- website/docs/guided-tour/rendering/queries.md | 2 +- website/docs/guided-tour/rendering/variables.md | 2 +- .../version-experimental/RelayHooks-AGuidedTourOfRelay.md | 8 ++++---- .../versioned_docs/version-v11.0.0/glossary/glossary.md | 4 ++-- .../version-v11.0.0/guided-tour/list-data/connections.md | 4 ++-- .../version-v11.0.0/guided-tour/rendering/queries.md | 2 +- .../version-v11.0.0/guided-tour/rendering/variables.md | 2 +- 10 files changed, 17 insertions(+), 17 deletions(-) diff --git a/packages/relay-runtime/network/RelayNetworkTypes.js b/packages/relay-runtime/network/RelayNetworkTypes.js index 14f977dfd7c24..afcfa47c03016 100644 --- a/packages/relay-runtime/network/RelayNetworkTypes.js +++ b/packages/relay-runtime/network/RelayNetworkTypes.js @@ -42,7 +42,7 @@ export type PayloadExtensions = {[key: string]: mixed, ...}; /** * The shape of a GraphQL response as dictated by the - * [spec](https://graphql.github.io/graphql-spec/June2018/#sec-Response-Format) + * [spec](https://spec.graphql.org/June2018/#sec-Response-Format). */ export type GraphQLResponseWithData = {| +data: PayloadData, diff --git a/website/docs/glossary/glossary.md b/website/docs/glossary/glossary.md index 1c1a1481706e9..d4ab3d4a66afe 100644 --- a/website/docs/glossary/glossary.md +++ b/website/docs/glossary/glossary.md @@ -508,7 +508,7 @@ TODO Querying a list of data (a [connection](#connection)) in parts is known as pagination. -See the [graphql docs](https://graphql.github.io/learn/pagination/) and our [guided tour](../guided-tour/list-data/pagination). +See the [graphql docs](https://graphql.org/learn/pagination/) and our [guided tour](../guided-tour/list-data/pagination). ## Payload @@ -564,7 +564,7 @@ Exposes mutator methods like `commitUpdate` that only add or remove updates from ## Query -A [GraphQL query](https://graphql.github.io/learn/queries/) is a request that can be sent to a GraphQL server in combination with a set of [variables](../guided-tour/rendering/variables), in order to fetch some data. It consists of a [selection](#selection) of fields, and potentially includes other [fragments](#fragment). +A [GraphQL query](https://graphql.org/learn/queries/) is a request that can be sent to a GraphQL server in combination with a set of [variables](../guided-tour/rendering/variables), in order to fetch some data. It consists of a [selection](#selection) of fields, and potentially includes other [fragments](#fragment). ## Query Executor diff --git a/website/docs/guided-tour/list-data/connections.md b/website/docs/guided-tour/list-data/connections.md index 4139a7c19560a..486d3e3daabf1 100644 --- a/website/docs/guided-tour/list-data/connections.md +++ b/website/docs/guided-tour/list-data/connections.md @@ -12,10 +12,10 @@ import DocsRating from '@site/src/core/DocsRating'; import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers'; import useBaseUrl from '@docusaurus/useBaseUrl'; -There are several scenarios in which we'll want to query a list of data from the GraphQL server. Often times we don't want to query the *entire* set of data up front, but rather discrete sub-parts of the list, incrementally, usually in response to user input or other events. Querying a list of data in discrete parts is usually known as [Pagination](https://graphql.github.io/learn/pagination/). +There are several scenarios in which we'll want to query a list of data from the GraphQL server. Often times we don't want to query the *entire* set of data up front, but rather discrete sub-parts of the list, incrementally, usually in response to user input or other events. Querying a list of data in discrete parts is usually known as [Pagination](https://graphql.org/learn/pagination/). -Specifically in Relay, we do this via GraphQL fields known as [Connections](https://graphql.github.io/learn/pagination/#complete-connection-model). Connections are GraphQL fields that take a set of arguments to specify which "slice" of the list to query, and include in their response both the "slice" of the list that was requested, as well as information to indicate if there is more data available in the list and how to query it; this additional information can be used in order to perform pagination by querying for more "slices" or pages on the list. +Specifically in Relay, we do this via GraphQL fields known as [Connections](https://graphql.org/learn/pagination/#complete-connection-model). Connections are GraphQL fields that take a set of arguments to specify which "slice" of the list to query, and include in their response both the "slice" of the list that was requested, as well as information to indicate if there is more data available in the list and how to query it; this additional information can be used in order to perform pagination by querying for more "slices" or pages on the list. More specifically, we perform *cursor-based pagination,* in which the input used to query for "slices" of the list is a `cursor` and a `count`. Cursors are essentially opaque tokens that serve as markers or pointers to a position in the list. If you're curious to learn more about the details of cursor-based pagination and connections, check out the spec. diff --git a/website/docs/guided-tour/rendering/queries.md b/website/docs/guided-tour/rendering/queries.md index 274ae5e2e8f67..1abae6fdf35d0 100644 --- a/website/docs/guided-tour/rendering/queries.md +++ b/website/docs/guided-tour/rendering/queries.md @@ -16,7 +16,7 @@ import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers'; import FbEntrypointsExtraInfo from './fb/FbEntrypointsExtraInfo.md'; -A [GraphQL Query](https://graphql.github.io/learn/queries/) is a description of data you want to query from a GraphQL server. It consists of a set of fields (and potentially [fragments](../fragments/)) that we want to request from the GraphQL server. What we can query for will depend on the [GraphQL Schema](https://graphql.github.io/learn/schema/) exposed on the server, which describes the data that is available for querying. +A [GraphQL Query](https://graphql.org/learn/queries/) is a description of data you want to query from a GraphQL server. It consists of a set of fields (and potentially [fragments](../fragments/)) that we want to request from the GraphQL server. What we can query for will depend on the [GraphQL Schema](https://graphql.org/learn/schema/) exposed on the server, which describes the data that is available for querying. A query can be sent as a request over the network, along with an optional collection of [variables](../variables/) that the query uses, in order to fetch the data. The server response will be a JSON object that matches the shape of the query we sent: diff --git a/website/docs/guided-tour/rendering/variables.md b/website/docs/guided-tour/rendering/variables.md index 1338136121bb2..851442c1156f1 100644 --- a/website/docs/guided-tour/rendering/variables.md +++ b/website/docs/guided-tour/rendering/variables.md @@ -11,7 +11,7 @@ keywords: import DocsRating from '@site/src/core/DocsRating'; import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers'; -You may have noticed that the query declarations in our examples above contain references to an `$id` symbol inside the GraphQL code: these are [GraphQL Variables](https://graphql.github.io/learn/queries/#variables). +You may have noticed that the query declarations in our examples above contain references to an `$id` symbol inside the GraphQL code: these are [GraphQL Variables](https://graphql.org/learn/queries/#variables). GraphQL variables are a construct that allows referencing dynamic values inside a GraphQL query. When fetching a query from the server, we also need to provide as input the actual set of values to use for the variables declared inside the query: diff --git a/website/versioned_docs/version-experimental/RelayHooks-AGuidedTourOfRelay.md b/website/versioned_docs/version-experimental/RelayHooks-AGuidedTourOfRelay.md index b79db54d93abb..c3728b94ff0ba 100644 --- a/website/versioned_docs/version-experimental/RelayHooks-AGuidedTourOfRelay.md +++ b/website/versioned_docs/version-experimental/RelayHooks-AGuidedTourOfRelay.md @@ -403,7 +403,7 @@ There are a few things to note here: ### Queries -A [GraphQL query](https://graphql.github.io/learn/queries/) is a request that can be sent to a GraphQL server in combination with a set of [Variables](#variables), in order to fetch some data. It consists of a selection of fields, and potentially includes other fragments: +A [GraphQL query](https://graphql.org/learn/queries/) is a request that can be sent to a GraphQL server in combination with a set of [Variables](#variables), in order to fetch some data. It consists of a selection of fields, and potentially includes other fragments: ```graphql @@ -571,7 +571,7 @@ Note that: ### Variables -You may have noticed that the query declarations in our examples above contain references to an `$id` symbol inside the GraphQL code: these are [GraphQL Variables](https://graphql.github.io/learn/queries/#variables). +You may have noticed that the query declarations in our examples above contain references to an `$id` symbol inside the GraphQL code: these are [GraphQL Variables](https://graphql.org/learn/queries/#variables). GraphQL variables are a construct that allows referencing dynamic values inside a GraphQL query. When fetching a query from the server, we also need to provide as input the actual set of values to use for the variables declared inside the query: @@ -2116,11 +2116,11 @@ Let's distill what's happening in this example: ## Rendering List Data and Pagination -There are several scenarios in which we'll want to query a list of data from the GraphQL server. Often times we won't want to query the _entire_ set of data up front, but rather discrete sub-parts of the list, incrementally, usually in response to user input or other events. Querying a list of data in discrete parts is usually known as [Pagination](https://graphql.github.io/learn/pagination/). +There are several scenarios in which we'll want to query a list of data from the GraphQL server. Often times we won't want to query the _entire_ set of data up front, but rather discrete sub-parts of the list, incrementally, usually in response to user input or other events. Querying a list of data in discrete parts is usually known as [Pagination](https://graphql.org/learn/pagination/). ### Connections -Specifically in Relay, we do this via GraphQL fields known as [Connections](https://graphql.github.io/learn/pagination/#complete-connection-model). Connections are GraphQL fields that take a set of arguments to specify which "slice" of the list to query, and include in their response both the "slice" of the list that was requested, as well as information to indicate if there is more data available in the list and how to query it; this additional information can be used in order to perform pagination by querying for more "slices" or pages on the list. +Specifically in Relay, we do this via GraphQL fields known as [Connections](https://graphql.org/learn/pagination/#complete-connection-model). Connections are GraphQL fields that take a set of arguments to specify which "slice" of the list to query, and include in their response both the "slice" of the list that was requested, as well as information to indicate if there is more data available in the list and how to query it; this additional information can be used in order to perform pagination by querying for more "slices" or pages on the list. More specifically, we perform _cursor-based pagination,_ in which the input used to query for "slices" of the list is a `cursor` and a `count`. Cursors are essentially opaque tokens that serve as markers or pointers to a position in the list. If you're curious to learn more about the details of cursor-based pagination and connections, check out [this spec](https://relay.dev/graphql/connections.htm). diff --git a/website/versioned_docs/version-v11.0.0/glossary/glossary.md b/website/versioned_docs/version-v11.0.0/glossary/glossary.md index 67984415d6a0c..112e95e7b8078 100644 --- a/website/versioned_docs/version-v11.0.0/glossary/glossary.md +++ b/website/versioned_docs/version-v11.0.0/glossary/glossary.md @@ -505,7 +505,7 @@ TODO Querying a list of data (a [connection](#connection)) in parts is known as pagination. -See the [graphql docs](https://graphql.github.io/learn/pagination/) and our [guided tour](../guided-tour/list-data/pagination). +See the [graphql docs](https://graphql.org/learn/pagination/) and our [guided tour](../guided-tour/list-data/pagination). ## Payload @@ -561,7 +561,7 @@ Exposes mutator methods like `commitUpdate` that only add or remove updates from ## Query -A [GraphQL query](https://graphql.github.io/learn/queries/) is a request that can be sent to a GraphQL server in combination with a set of [variables](../guided-tour/rendering/variables), in order to fetch some data. It consists of a [selection](#selection) of fields, and potentially includes other [fragments](#fragment). +A [GraphQL query](https://graphql.org/learn/queries/) is a request that can be sent to a GraphQL server in combination with a set of [variables](../guided-tour/rendering/variables), in order to fetch some data. It consists of a [selection](#selection) of fields, and potentially includes other [fragments](#fragment). ## Query Executor diff --git a/website/versioned_docs/version-v11.0.0/guided-tour/list-data/connections.md b/website/versioned_docs/version-v11.0.0/guided-tour/list-data/connections.md index 43e8c858292d9..d5d42f40172f5 100644 --- a/website/versioned_docs/version-v11.0.0/guided-tour/list-data/connections.md +++ b/website/versioned_docs/version-v11.0.0/guided-tour/list-data/connections.md @@ -8,10 +8,10 @@ import DocsRating from '@site/src/core/DocsRating'; import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers'; import useBaseUrl from '@docusaurus/useBaseUrl'; -There are several scenarios in which we'll want to query a list of data from the GraphQL server. Often times we don't want to query the *entire* set of data up front, but rather discrete sub-parts of the list, incrementally, usually in response to user input or other events. Querying a list of data in discrete parts is usually known as [Pagination](https://graphql.github.io/learn/pagination/). +There are several scenarios in which we'll want to query a list of data from the GraphQL server. Often times we don't want to query the *entire* set of data up front, but rather discrete sub-parts of the list, incrementally, usually in response to user input or other events. Querying a list of data in discrete parts is usually known as [Pagination](https://graphql.org/learn/pagination/). -Specifically in Relay, we do this via GraphQL fields known as [Connections](https://graphql.github.io/learn/pagination/#complete-connection-model). Connections are GraphQL fields that take a set of arguments to specify which "slice" of the list to query, and include in their response both the "slice" of the list that was requested, as well as information to indicate if there is more data available in the list and how to query it; this additional information can be used in order to perform pagination by querying for more "slices" or pages on the list. +Specifically in Relay, we do this via GraphQL fields known as [Connections](https://graphql.org/learn/pagination/#complete-connection-model). Connections are GraphQL fields that take a set of arguments to specify which "slice" of the list to query, and include in their response both the "slice" of the list that was requested, as well as information to indicate if there is more data available in the list and how to query it; this additional information can be used in order to perform pagination by querying for more "slices" or pages on the list. More specifically, we perform *cursor-based pagination,* in which the input used to query for "slices" of the list is a `cursor` and a `count`. Cursors are essentially opaque tokens that serve as markers or pointers to a position in the list. If you're curious to learn more about the details of cursor-based pagination and connections, check out the spec. diff --git a/website/versioned_docs/version-v11.0.0/guided-tour/rendering/queries.md b/website/versioned_docs/version-v11.0.0/guided-tour/rendering/queries.md index 9f1fdc63423b7..b16a23bef74a8 100644 --- a/website/versioned_docs/version-v11.0.0/guided-tour/rendering/queries.md +++ b/website/versioned_docs/version-v11.0.0/guided-tour/rendering/queries.md @@ -9,7 +9,7 @@ import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers'; import FbEntrypointsExtraInfo from './fb/FbEntrypointsExtraInfo.md'; -A [GraphQL Query](https://graphql.github.io/learn/queries/) is a description of data you want to query from a GraphQL server. It consists of a set of fields (and potentially [fragments](../fragments/)) that we want to request from the GraphQL server. What we can query for will depend on the [GraphQL Schema](https://graphql.github.io/learn/schema/) exposed on the server, which describes the data that is available for querying. +A [GraphQL Query](https://graphql.org/learn/queries/) is a description of data you want to query from a GraphQL server. It consists of a set of fields (and potentially [fragments](../fragments/)) that we want to request from the GraphQL server. What we can query for will depend on the [GraphQL Schema](https://graphql.org/learn/schema/) exposed on the server, which describes the data that is available for querying. A query can be sent as a request over the network, along with an optional collection of [variables](../variables/) that the query uses, in order to fetch the data. The server response will be a JSON object that matches the shape of the query we sent: diff --git a/website/versioned_docs/version-v11.0.0/guided-tour/rendering/variables.md b/website/versioned_docs/version-v11.0.0/guided-tour/rendering/variables.md index 17e71e32c1c49..511569e27ced6 100644 --- a/website/versioned_docs/version-v11.0.0/guided-tour/rendering/variables.md +++ b/website/versioned_docs/version-v11.0.0/guided-tour/rendering/variables.md @@ -7,7 +7,7 @@ slug: /guided-tour/rendering/variables/ import DocsRating from '@site/src/core/DocsRating'; import {OssOnly, FbInternalOnly} from 'internaldocs-fb-helpers'; -You may have noticed that the query declarations in our examples above contain references to an `$id` symbol inside the GraphQL code: these are [GraphQL Variables](https://graphql.github.io/learn/queries/#variables). +You may have noticed that the query declarations in our examples above contain references to an `$id` symbol inside the GraphQL code: these are [GraphQL Variables](https://graphql.org/learn/queries/#variables). GraphQL variables are a construct that allows referencing dynamic values inside a GraphQL query. When fetching a query from the server, we also need to provide as input the actual set of values to use for the variables declared inside the query: