Skip to content

Commit b3bcabe

Browse files
author
Prosper Otemuyiwa
authored
Merge pull request apollographql#197 from Babsvik/patch-1
Updated faq
2 parents b312f34 + 91cb867 commit b3bcabe

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

docs/source/resources/faq.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Other DataSources are under development, but even without the `DataSource` API,
6060

6161
#### How do I design the schema?
6262

63-
Schemas should be designed with the needs of the client in mind. Rather than modeling queries and types after the underlying services, they should be designed to make querying as easy as possible. GraphQL's resolver structure makes it possible to allow this flexibility without many performance consequences. For more, read the [schema design guide](./schema-design.html).
63+
Schemas should be designed with the needs of the client in mind. Rather than modeling queries and types after the underlying services, they should be designed to make querying as easy as possible. GraphQL's resolver structure makes it possible to allow this flexibility without many performance consequences. For more, read the [schema design guide](../guides/schema-design.html).
6464

6565
#### How do I discover and reproduce errors?
6666

@@ -84,11 +84,11 @@ GraphQL schemas work best when their design is heavily influenced by the needs o
8484

8585
#### How do I set up authentication/authorization for my GraphQL schema?
8686

87-
Authentication and authorization are important topics to discuss with any API. GraphQL provides a very granular approch to handling these topics. But don't worry! If an API being consumed by GraphQL already has authorization built-in, it may be possible to ignore it completely! Read more in the [access control guide](./access-control.html).
87+
Authentication and authorization are important topics to discuss with any API. GraphQL provides a very granular approch to handling these topics. But don't worry! If an API being consumed by GraphQL already has authorization built-in, it may be possible to ignore it completely! Read more in the [access control guide](../guides/access-control.html).
8888

8989
#### How can I secure my schema from malicious or expensive queries?
9090

91-
Public APIs of any kind need some kind of safeguards against malicious queries. Since GraphQL allows for recursive queries, it wouldn't be hard to create a query that is overly complicated and acts as a DoS attack, even by accident. There are multiple ways to prevent something like this from happening, from complexity limiting to query depth limiting. Read the [guide on security](./security.html) to learn more.
91+
Public APIs of any kind need some kind of safeguards against malicious queries. Since GraphQL allows for recursive queries, it wouldn't be hard to create a query that is overly complicated and acts as a DoS attack, even by accident. There are multiple ways to prevent something like this from happening, from complexity limiting to query depth limiting. Read the [guide on security](../guides/security.html) to learn more.
9292

9393
#### What kinds of cache should I setup?
9494

@@ -122,10 +122,10 @@ Keeping all schema code together makes sense for smaller projects, but once a pr
122122

123123
#### How can I test my client?
124124

125-
`react-apollo` comes with everything needed to test a client app that makes queries to a GraphQL schema. Read the [Testing React Components](./testing-react-components.html) guide to learn more.
125+
`react-apollo` comes with everything needed to test a client app that makes queries to a GraphQL schema. Read the [Testing React Components](../guides/testing-react-components.html) guide to learn more.
126126

127127
#### How can I safely make changes to the schema?
128128

129-
Schemas naturally evolve over time. GraphQL schemas are more resilient to change than other APIs, but there are still occasions where breaking changes will need to happen to support new functionality. The [versioning guide](./versioning.html) explains in more detail what kinds of changes are safe to make, and what kinds could break existing clients.
129+
Schemas naturally evolve over time. GraphQL schemas are more resilient to change than other APIs, but there are still occasions where breaking changes will need to happen to support new functionality. The [versioning guide](../guides/versioning.html) explains in more detail what kinds of changes are safe to make, and what kinds could break existing clients.
130130

131131
Additionally, using the [Apollo CLI](https://www.npmjs.com/package/apollo) with Apollo Engine provides the tools needed to [validate schema changes](https://www.apollographql.com/docs/engine/features/schema-history.html) over time. This makes collaboration easier and more transparent.

0 commit comments

Comments
 (0)