Jesse Rosenberger
0fa335ddc8
Change "Naming" to "Style conventions".
...
Keeping in mind that capitalization differences are not "naming"
conventions, and that there were no other recommendations for naming (e.g.
"begin each fetcher with "Get", etc.), I've changed this section to
"Style conventions".
2018-04-29 18:35:15 +03:00
Jesse Rosenberger
150423f53f
Rework Security Introspection.
2018-04-27 21:59:36 +03:00
Jesse Rosenberger
a212f5cb61
Rename page fragment to just 'introspection'.
2018-04-27 21:47:10 +03:00
Jesse Rosenberger
a4ae542e61
Re-work introduction to Security Best Practices.
...
While GraphQL is less susceptible to injection attacks, this introduction
made it sound like it wasn't possible, but the first paragraph then
demonstrated an injection attack and how to prevent it.
2018-04-27 21:42:04 +03:00
Jesse Rosenberger
d5fe357536
Re-work introduction on Best Practices > Performance.
2018-04-27 21:40:04 +03:00
Jesse Rosenberger
5091121228
Quick first pass, mostly spelling.
2018-04-27 19:16:00 +03:00
Jesse Rosenberger
e85fc6c347
Nits and editorial on earlier content in Schema
2018-04-27 18:18:11 +03:00
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
Renovate Bot
c43d9bda04
chore(deps): update dependency remap-istanbul to v0.11.1
2018-04-26 07:02:11 +00: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
Renovate Bot
297e501231
chore(deps): update dependency lerna to v2.11.0
2018-04-25 11:02:21 +00: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
Renovate Bot
3815aa63cf
chore(deps): update dependency @types/koa-router to v7.0.28
2018-04-25 09:46:24 +00:00
Jesse Rosenberger
8eaa998c43
docs: Essentials / Server (now, with middleware!)
2018-04-25 12:28:32 +03:00
Renovate Bot
d8fecdc5c8
chore(deps): update dependency @types/body-parser to v1.17.0
2018-04-25 08:02:19 +00:00
Renovate Bot
363171bff2
chore(deps): update dependency @types/aws-lambda to v8.10.2
2018-04-25 06:52:23 +00:00
Evans Hauser
cd88fbe695
add creating schema directives to advanced section
2018-04-24 15:16:11 -07:00
David Glasser
b32e89c060
v1.3.6
2018-04-24 11:35:14 -07:00
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
