David Glasser
8bd1ad0a6d
CHANGELOG update
2018-04-24 11:32:30 -07:00
Jake
57b56427dc
[WIP] refined data fetching essentials
2018-04-24 12:55:02 -04:00
Jesse Rosenberger
4ff36d8575
docs: Sidebar: "Schema Development" > "Schema". (To fit on a single line.)
2018-04-24 18:00:19 +03:00
Jesse Rosenberger
88adbdbe86
Add "Next steps" for consistency with other sections.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
a2b926fbc0
Remove SCRATCHPAD.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
9145c5cc6c
Fix typo in named operations.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
ed016762f7
Shorten operation name.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
f57cd6b34a
docs: Variables as arguments.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
1b9d32ddb0
s/name/identifier/ for named operations.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
84c41ce21a
docs: Respond to @evans feedback about programmatic introspection.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
096e86821d
docs: Clarify arguments.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
9635b794fb
docs: Draw attention to two of REST's downfalls: over-fetching and stiching.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
569c826470
TODO: Passing arguments as variables.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
d3ea5004f2
Essentials > Schema > Operation Names
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
937e7ff5d4
Essentials > Schema > Introspection.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
3cdbac47be
Make it more clear that introspection is optional.
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
11adbf5749
Variables section, WIP header
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
51b1f339e2
Essentials > Schema, Part 2 (Mostly Mutations)
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
a0c64e78c0
Essentials > Schema, Part one (mainly "Queries").
2018-04-24 17:58:44 +03:00
Jesse Rosenberger
b2fa5d0c7d
Merge branch 'master' into docs-overhaul
2018-04-24 16:59:22 +03:00
Jesse Rosenberger
5d7e281aa1
Pin npm to 5, at least for the time-being. ( #984 )
...
npm 6 deprecates support for Node.js 4, which is still LTS until the end of
the week.
It's probably best to take a moment and ensure that npm@6 is actually
working as we desire too, so this is just to make sure that we don't end up
with a bunch of PRs that need to be re-based/re-tested, which seems to
already be happening.
2018-04-24 16:55:52 +03:00
Jesse Rosenberger
32a83b3686
docs: Change GraphQL Subscriptions title to match package name for API.
2018-04-24 14:18:40 +03:00
Jesse Rosenberger
1e1c7fd6b2
docs: Mock out API > apollo-server.
2018-04-24 14:17:51 +03:00
Jesse Rosenberger
36a07bb3bb
docs: API reference: Link to graphql-tools.
2018-04-24 14:17:04 +03:00
David Glasser
e2df79d06c
core: return PersistedQueryNotSupported for Apollo Persisted Queries ( #982 )
...
Apollo Persisted Queries is a standard for sending queries as short hashes
instead of full strings, designed to work well with GET requests. It is
implemented by servers including the Apollo Engine Proxy, and by the
apollo-link-persisted-query client.
A common configuration is to set up persisted queries on production servers but
not in development. It is still convenient to leave apollo-link-persisted-query
always on, though. While apollo-link-persisted-query can detect that servers
don't support PQs, it works better if the server actually says it doesn't
support the PQ, instead of trying to process a request without a query and
potentially printing a confusing stack trace. This commit makes apollo-server
directly return PersistedQueryNotSupported instead of allowing confusing stack
traces to occur.
2018-04-24 06:29:07 -04:00
Evans Hauser
723b52845a
standardize organization of typeDefs using concat and fixed extend example
2018-04-23 22:46:43 -07:00
Jake Dawkins
4fae3da13e
added some detail and fixed grammar ( #981 )
2018-04-23 22:04:15 +03:00
James Baxley
bdc2a82db8
docs: Best practices ( #978 )
...
* clean up some code examples
* add in some best practies
2018-04-23 22:01:54 +03:00
Jesse Rosenberger
e4977737e9
Rename slugs for "Essentials" pages to match other naming conventions.
...
Plus, slugs.
cc @JakeDawkins
2018-04-23 19:04:03 +03:00
Jesse Rosenberger
c65b7a57bf
Merge remote-tracking branch 'origin/master' into docs-overhaul
2018-04-23 15:28:29 +03:00
Jesse Rosenberger
ac6411b238
Further-remove "Query Mechanics", this time from the sidebar.
...
It was already deleted elsewhere.
2018-04-23 12:47:18 +03:00
Jesse Rosenberger
ded3aeb708
The backends section has been temporarily eradicated.
2018-04-23 12:29:44 +03:00
Evans Hauser
99a39907f4
add advanced section for scalars and enums
2018-04-22 23:40:56 -07:00
Evans Hauser
899dc68cd3
schema organization now places resolvers next to typeDefs
2018-04-22 22:53:29 -07:00
Renovate Bot
d74f5e78e6
chore(deps): update dependency @types/chai to v4.1.3
2018-04-21 06:56:11 +00:00
Evans Hauser
74431f57b7
initial information about schema organization lifted from GraphQL tools
2018-04-20 18:56:49 -07:00
Evans Hauser
4cb76e89e1
flesh out the schema/types
2018-04-20 16:30:02 -07:00
Evans Hauser
e3ea618788
resolvers and directives sections lifted from graphql-tools
2018-04-20 14:51:04 -07:00
Jesse Rosenberger
82caa753cd
Shuffle schema/query/resolver content bucketing.
2018-04-20 22:01:49 +03:00
Jesse Rosenberger
200c385757
Remove some leftover artifacts.
2018-04-20 21:54:51 +03:00
Evans Hauser
c7854a469c
add mutation sections to authentication and import -> require
2018-04-20 11:33:44 -07:00
Jesse Rosenberger
6042c08011
Random spelling fixes.
2018-04-20 21:16:46 +03:00
Jesse Rosenberger
3acdacbfa9
Context 👋
2018-04-20 20:36:32 +03:00
Jesse Rosenberger
1d09c86f32
title: Fetching data
2018-04-20 20:25:23 +03:00
Jesse Rosenberger
f2b27a6630
Title: Running a server.
2018-04-20 20:22:52 +03:00
Jesse Rosenberger
476433418c
Change subtitles.
2018-04-20 20:03:50 +03:00
Jesse Rosenberger
cb792f5f0d
Use a directory called images instead of img.
...
While a lose convention, `images` is more common and more explicit.
2018-04-20 19:38:48 +03:00
Jesse Rosenberger
b605f43115
Follow up on deploy => deployment renaming.
2018-04-20 19:36:08 +03:00
Jesse Rosenberger
7e58b7a24d
GraphQL syntax highlighting with "graphql" type.
2018-04-20 19:35:27 +03:00
Jesse Rosenberger
70c1d79a64
Bash syntax highlighting to just "Shell".
2018-04-20 19:34:35 +03:00
