Life is h as d and so is learning GraphQL @carolstran meeshkan.com - - PowerPoint PPT Presentation

▶
life is h as d
SMART_READER_LITE
LIVE PREVIEW

Life is h as d and so is learning GraphQL @carolstran meeshkan.com - - PowerPoint PPT Presentation

Jun 10, 2023 353 likes •1.16k views

Life is h as d and so is learning GraphQL @carolstran meeshkan.com github.com/unmock queerjs.com globaldiversitycfpday.com @carolstran @carolstran @carolstran graph.cool @carolstran @carolstran @carolstran @carolstran @carolstran

slide-1
SLIDE 1

Life is hasd

and so is learning GraphQL

@carolstran

slide-2
SLIDE 2

meeshkan.com

slide-3
SLIDE 3

github.com/unmock

slide-4
SLIDE 4

queerjs.com

slide-5
SLIDE 5

globaldiversitycfpday.com

slide-6
SLIDE 6

@carolstran

slide-7
SLIDE 7

@carolstran

slide-8
SLIDE 8

@carolstran graph.cool

slide-9
SLIDE 9

@carolstran

slide-10
SLIDE 10

@carolstran

slide-11
SLIDE 11

@carolstran

slide-12
SLIDE 12

@carolstran

slide-13
SLIDE 13

@carolstran

slide-14
SLIDE 14

@carolstran

slide-15
SLIDE 15

@carolstran

slide-16
SLIDE 16

@carolstran

slide-17
SLIDE 17

@carolstran

slide-18
SLIDE 18

GraphQL

@carolstran

slide-19
SLIDE 19

GraphQL

@carolstran

slide-20
SLIDE 20

@carolstran

slide-21
SLIDE 21

@carolstran

slide-22
SLIDE 22

Go to GraphiQL and “try it out”

@carolstran bit.ly/graphiql-demo

slide-23
SLIDE 23

Work your way through the documentation

@carolstran graphql.org

slide-24
SLIDE 24

@carolstran graphql.org

slide-25
SLIDE 25

@carolstran

slide-26
SLIDE 26

@carolstran

slide-27
SLIDE 27

@carolstran

slide-28
SLIDE 28

@carolstran graphql.org

slide-29
SLIDE 29

@carolstran graphql.org

slide-30
SLIDE 30

@carolstran graphql.org/learn

slide-31
SLIDE 31

@carolstran graphql.org/learn

slide-32
SLIDE 32

@carolstran

slide-33
SLIDE 33

@carolstran

slide-34
SLIDE 34

@carolstran

Anyone who encounters GraphQL, needs to be able to understand it

slide-35
SLIDE 35

@carolstran gatsbyjs.org

slide-36
SLIDE 36

@carolstran

slide-37
SLIDE 37

The problems

and what we can do about it

@carolstran

slide-38
SLIDE 38

Just because GraphQL is “self- documenting," doesn’t mean you should stop writing docs

@carolstran

Problem

slide-39
SLIDE 39

@carolstran bit.ly/github-gql-api

slide-40
SLIDE 40

@carolstran bit.ly/github-gql-api

slide-41
SLIDE 41

“This type of documentation is great after you understand the domain area and the business cases and you’ve built some confidence making queries and mutations…

@carolstran

— Andrew Johnston

bit.ly/andrew-api-docs

slide-42
SLIDE 42

…but without more detailed documentation that covers the conceptual materials, you’re not going to get there.”

@carolstran

— Andrew Johnston

bit.ly/andrew-api-docs

slide-43
SLIDE 43

“Documenting API endpoints explains how individual tools work, explaining how to use those tools together is a whole

  • ther area of documentation effort. ”

@carolstran

— Chris Ward

bit.ly/documenting-graphql

slide-44
SLIDE 44

@carolstran gatsbyjs.org/docs/querying-with-graphql/

slide-45
SLIDE 45

GraphQL is dominated by the JavaScript community

@carolstran

Problem

slide-46
SLIDE 46

@carolstran bit.ly/graphql-def

slide-47
SLIDE 47

@carolstran

slide-48
SLIDE 48

@carolstran

JavaScript TypeScript Ruby PHP Python Java C/C++ Swift .NET Erlang Elixir Haskell Rust Go Scala Clojure R (and more)

slide-49
SLIDE 49

@carolstran graphql.org/learn

slide-50
SLIDE 50

@carolstran graphql.org/learn

slide-51
SLIDE 51

@carolstran graphql.org/code

slide-52
SLIDE 52

Assumed knowledge and specific terminology

Problem

@carolstran

slide-53
SLIDE 53

@carolstran

Everyone is a beginner at some point

slide-54
SLIDE 54

Listing pre-reqs for a tutorial will help prevent headaches

@carolstran

slide-55
SLIDE 55

@carolstran bit.ly/graphql-glossary

slide-56
SLIDE 56

@carolstran bit.ly/fb-graphapi

slide-57
SLIDE 57

Quick wins

some short documentation tips

@carolstran

slide-58
SLIDE 58

Be confident with your definitions

Quick win

@carolstran

slide-59
SLIDE 59

There’s a time and place for analogies

Quick win

@carolstran

slide-60
SLIDE 60

@carolstran

slide-61
SLIDE 61

There’s a time and place for analogies

Quick win

@carolstran

(and that place is Twitter)

slide-62
SLIDE 62

@carolstran bit.ly/burger-tweet

slide-63
SLIDE 63

Don’t integrate tools or services without explanation

Quick win

@carolstran

slide-64
SLIDE 64

Be transparent about any downfalls

Quick win

@carolstran

slide-65
SLIDE 65

Mose resovrces

for learning GraphQL and beyond

@carolstran

slide-66
SLIDE 66

HowToGraphQL.com

Resovrce

@carolstran

slide-67
SLIDE 67

@carolstran howtographql.com

slide-68
SLIDE 68

A Frontend Developer’s Guide to GraphQL

Resovrce

@carolstran github.com/peggyrayzis/guide-to-graphql

slide-69
SLIDE 69

@carolstran css-tricks.com/front-end-developers-guide-graphql/

slide-70
SLIDE 70

GitHub's GraphQL API

Resovrce

@carolstran bit.ly/github-gql-api

slide-71
SLIDE 71

@carolstran bit.ly/github-gql-api

slide-72
SLIDE 72

Community Resources on

  • fficial GraphQL docs

Resovrce

@carolstran graphql.org/community

slide-73
SLIDE 73

@carolstran graphql.org/community

slide-74
SLIDE 74

https://so-you-want-to-learn- graphql.netlify.com/

Resovrce

@carolstran github.com/carolstran/so-you-want-to-learn-graphql

slide-75
SLIDE 75

@carolstran github.com/carolstran/so-you-want-to-learn-graphql

slide-76
SLIDE 76

One last thing

(but actually, I promise)

@carolstran

slide-77
SLIDE 77

@carolstran bit.ly/javascript-monads

slide-78
SLIDE 78

@carolstran

Please don’t let GraphQL become the new monads