Commit graph

46 commits

Author SHA1 Message Date
Jesse Rosenberger
011f0063aa
docs: Update links to new schema concepts. 2018-04-30 17:25:30 -07:00
Jesse Rosenberger
761ff92bb8
docs: Iteration from Docs workshop.
* Bury Best Practices, for the time being.
* Bury Schema, but leave it on disk.
* Introduce new Querying section.
* Move "Why Apollo Server?" into "Index".
   * ...to be refined.
* Remove no-longer-helpful "Getting Started" from "Index".

cc @stubailo @evans @peggyrayzis @JakeDawkins @unicodeveloper @jbaxleyiii
2018-04-30 15:36:08 -07:00
Jesse Rosenberger
fe6ee688a2
Merge pull request #985 from apollographql/docs-essentials-data
[Work in Progress] docs: essentials > data
2018-04-30 22:09:28 +03:00
Jesse Rosenberger
e273c35ba7
Merge branch 'docs-overhaul' into docs-essentials-data 2018-04-30 22:05:13 +03:00
Jesse Rosenberger
e85fc6c347
Nits and editorial on earlier content in Schema 2018-04-27 18:18:11 +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
Jake
57b56427dc [WIP] refined data fetching essentials 2018-04-24 12:55:02 -04: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
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
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
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
7e58b7a24d
GraphQL syntax highlighting with "graphql" type. 2018-04-20 19:35:27 +03:00
Jesse Rosenberger
ac8d19a594
Backends 👋 2018-04-20 17:44:40 +03:00
Jesse Rosenberger
d0b24a2381
Follow-up on previous commit. 2018-04-20 17:29:11 +03:00
Jesse Rosenberger
e2c2e200f4
Move building queries and mutations into building a schema. 2018-04-20 17:20:30 +03:00
Jesse Rosenberger
0e8e490ba1
Re-structure per conversation with @evans and @jbaxleyiii. 2018-04-20 17:12:18 +03:00
Jesse Rosenberger
dd2a79e929
Move query mechanics into schema essentials. 2018-04-20 15:30:18 +03:00
Jesse Rosenberger
6e82434124
A spellcheck pass. 2018-04-19 14:51:15 +03:00
Jesse Rosenberger
8d5a37f1f0
👾 Update docs with content from Glitch. 2018-04-19 14:19:36 +03:00
James Baxley
2d9b47bc2d updates from feedback with @abernix 2018-04-05 09:53:52 -04:00
James Baxley
53efef676e added some more outlines 2018-04-05 02:31:10 -04:00
James Baxley
acbfba50ab initial starting point for new docs 2018-04-05 01:24:56 -04:00