Jesse Rosenberger
1ae3ce2dc7
Remove grave accents, which do not work for titles.
2018-04-27 17:02:33 +03:00
Jesse Rosenberger
dfa4f61940
Merge branch 'docs-overhaul' into abernix/docs/api
2018-04-27 17:02:11 +03:00
Jesse Rosenberger
02f5c467ac
Change apollo-engine title to be without grave accents.
2018-04-27 17:01:57 +03:00
Jesse Rosenberger
d2ec5bb6d5
Clarify that gql must be imported, per feedback from @peggyrayzis.
2018-04-27 16:55:04 +03:00
Jesse Rosenberger
198b109e20
Drop ApolloServer.prototype. per feedback from @peggyrayzis.
2018-04-27 16:51:57 +03:00
Jesse Rosenberger
9625c0a7e2
Merge branch 'docs-overhaul' into abernix/docs/api
2018-04-27 16:41:43 +03:00
Jesse Rosenberger
0482216a64
docs: API: Change "Apollo Engine" title to be apollo-engine.
2018-04-27 16:41:11 +03:00
Jesse Rosenberger
7ce3099158
Bump the hexo version, which keeps getting lowered, back to 3.7.1.
2018-04-26 23:04:38 +03:00
Jesse Rosenberger
790ebbea7b
docs: API > apollo-server.
2018-04-26 22:37:14 +03:00
Evans Hauser
5f835cbbf1
docs: add short section to what's new about errors
2018-04-26 12:27:07 -07:00
Jesse Rosenberger
c09b352c95
docs: Add v2 to the versions property in _config.yml.
...
This should enable the dropdown box in the sidebar of the documentation.
Currently, that sidebar will be a terrible color, since it has never
appeared on Apollo documentation before and nobody has ever defined style on
it. That'll have to be fixed in the theme itself[0].
[0]: https://github.com/meteor/meteor-theme-hexo
2018-04-26 14:35:53 +03:00
Evans Hauser
80e0c30782
docs: add missing ` in essentials/server
2018-04-25 15:25:07 -07:00
Jesse Rosenberger
b6bdfdbbad
docs: Add instruction for applyMiddleware.
2018-04-25 22:15:34 +03:00
Jesse Rosenberger
16e1286259
docs: Add color about app, and where it might be found in existing applications.
2018-04-25 14:05:27 +03:00
Jesse Rosenberger
c1744faec6
docs: Improve "apollo-server/<variant>" explanation.
2018-04-25 14:04:46 +03:00
Jesse Rosenberger
5317483a83
docs: Simplify explanation of graphql.
2018-04-25 14:04:04 +03:00
Jesse Rosenberger
6e98ba57ef
docs: Use gql template literal tag in all examples.
...
While the `gql` tag is not currently _required_, it does make it easier to
implement additional, development-friendly functionality in the future.
For example, it could avoid the need to question whether a string literal is
actually using Schema Definition Language (SDL) and avoid the need to
look for context clues.
By implementing these suggestions now, we can avoid the need to ask
developers to refactor in the future.
2018-04-25 14:00:33 +03:00
Jesse Rosenberger
8eaa998c43
docs: Essentials / Server (now, with middleware!)
2018-04-25 12:28:32 +03:00
Evans Hauser
cd88fbe695
add creating schema directives to advanced section
2018-04-24 15:16:11 -07: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
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
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
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
