Skip to content

Instantly share code, notes, and snippets.

@jameslmartin

jameslmartin/graphql-reading-list.md

Last active October 4, 2023 20:21
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save jameslmartin/235e6265b2cb03e88e50a308fc218f2b to your computer and use it in GitHub Desktop.
Save jameslmartin/235e6265b2cb03e88e50a308fc218f2b to your computer and use it in GitHub Desktop.
Download ZIP
GraphQL Reading List
Raw
graphql-reading-list.md

GraphQL is an API technology developed by Facebook and released to the public in 2015

GraphQL background

In chronological order:

  1. Martin Fowler on the Richardson Maturity Model, 2010. Not specific to GraphQL but a good primer on API design.
  2. Lee Byron (Facebook) on GraphQL Core Principles / Exploring GraphQL, conference talk at react-europe 2015. I like watching conference talks at 1.25x or 1.5x speed.
  3. Apollo GraphQL reaches 1.0 in 2017, AppSync released. Skim 2017 in GraphQL on the Apollo Blog, not a ton of useful info but 2017 was a landmark year for GraphQL adoption
  4. Apollo introduces Federation, allowing data to be stitched together from subgraphs
  5. Read about Federation core concepts. This documentation is specific to Apollo but nonetheless speaks to the same core concepts of the federated Global Graph at Guild.

Guild-specific Documentation

Now you have some good background around API design, GraphQL, and Federation. Check out these documents in order to get more context of GraphQL at Guild.

  1. Bill Lee wrote a General Guide to GraphQL with the lens of using GraphQL at Guild.
  2. Spencer Post spent time recording a series of demos that starts using GraphQL from a blank project. He demonstrates how to onboard onto the Gateway, perform type merging, and touches on how to paginate and handle errors.
    1. Part One on type merging
    2. Part Two using lambda resolvers
    3. Part Three on best practices around pagination and error handling
  3. Spencer also recorded a demo of how to create a CodeFirstSubgraph using the Guild CDK constructs. The CodeFirstSubgraph is a way to build subgraphs of the Gateway at a higher level via Infrastructure as Code, rather than defining a schema and all the moving pieces to resolve fields and types in said schema. He starts his demo from npm init.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment