Improving the GitHub Developer experience with GraphQL

The move to GraphQL marked a larger shift in GitHub's Platform strategy towards more transparency and more flexibility in our API. Over the past year, GitHub has been iterating on their schema to bring it closer towards feature completeness and strengthening the use for 3rd party integrators. Join me in walking through some of the newer ways developers are leveraging our API primitives and benefiting from GraphQL adoption into their development workflow.

Transcript

1. Improving the GitHub Developer Experience with GraphQL @bdougieYO
2. Sampling GraphQL sandwich.netlify.com @bdougieYO @bdougieYO
3. @bdougieYO @bdougieYO @bdougieYO @bdougieYO
4. sampled disco tracks sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
5. Grand Master Flash & The Furious Five @bdougieYO @bdougieYO @bdougieYO @bdougieYO
6. “the message” sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
7. rap became social commentary sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
8. gansta rap sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
9. @bdougieYO @bdougieYO @bdougieYO @bdougieYO N.W.A Public Enemy
10. sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
11. “ain't nothin' but a gangsta party” sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO (2 of Amerikaz most wanted)
12. 1996 sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
13. give it a REST! sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
14. Developer AdvocateTools Brian Douglas Money$ign @bdougieYO @bdougie @bdougieYO
16. GitHub GraphQL API @bdougieYO sandwich.netlify.com @bdougieYO
17. GitHub chose GraphQL to provide more flexibility for our integrators. sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
18. • Integrators • Flexibility sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO improved experience
19. GitHub is a collaboration platform. We provide enough features and get out of the way of the developer. @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
20. better hooks sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
21. sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO Puff Daddy (P Diddy)
22. 1997 sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
23. sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO (wrap changed forever)
24. sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO (even will came back to rap)
25. 2016 sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
26. GitHub sampled GraphQL sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
27. @bdougieYO sandwich.netlify.com @bdougieYO JAMstack Radio Podcast #5 @bdougieYO
28. 2017 sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
29. GitHub launched their GraphQL-first API sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
30. hooks: inconsitency sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
31. sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO • Inconsistent REST API • Reference documentation maintenance hooks: documentation
32. @bdougieYO sandwich.netlify.com @bdougieYO GraphQL Explorer @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
33. @bdougieYO developer.github.com/v4/explorer/ Query @bdougieYO @bdougieYO @bdougieYO @bdougieYO
34. @bdougieYO developer.github.com/v4/explorer/ Data @bdougieYO @bdougieYO @bdougieYO @bdougieYO
35. @bdougieYO developer.github.com/v4/explorer/ @bdougieYO @bdougieYO @bdougieYO @bdougieYO Documentation
36. I wanted to try this new GraphQL API by building a new project @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
37. GitHub is the place to discover open source @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
38. I want to get involved in Open Source @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
39. but every-time I find a project I don't know where to start @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
40. ~Gucci Mane The Godfather of Trap Music @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
41. Gucci Mane sampled “Lovin’ You” @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
42. ~Gucci Mane If you don’t got sauce, then you lost @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
43. an open source project to manage open source projects @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
44. @bdougieYO opensauced.pizza @bdougieYO @bdougieYO @bdougieYO @bdougieYO
45. a way to save and take notes on projects to rediscover later @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
46. I was hungry to learn the GitHub GraphQL API @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
47. @bdougieYO GitHub GraphQL API Open Sauced Prisma Fetching repo data Fetching saved notes Saving notes @bdougieYO @bdougieYO @bdougieYO @bdougieYO
48. I sampled GitHub to build my integration @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
49. stitching my app with the GitHub API @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO
50. Who is using the GitHub GraphQL API? sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
51. GitHub (200+ contributors) sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
52. @bdougieYO @bdougieYO @bdougieYO @bdougieYO
53. I sampled my REST API to power my GraphQL API sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
54. GitHub is powering their REST API with the GraphQL API sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
55. The GitHub REST API is not going anywhere sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
56. GitHub Apps
57. allow integrators the flexibility to request specific access to resources and act as a first class actor without taking up a paid seat within an organization. @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO @bdougieYO GitHub Apps
58. probot.github.io @bdougieYO
59. automate workflows @bdougieYO By leveraging the GitHub API
60. @bdougieYO identify repeated tasks “We {action} every {period of time}.”
61. pull reminders @bdougieYO
62. @bdougieYO identify repeated tasks “We review pull request once a day.”
63. listen on webhooks @bdougieYO Take action via the GitHub API
64. @bdougieYO
65. @bdougieYO
66. @bdougieYO Probot + Octokit
67. @bdougieYO GraphQL + Octokit
68. the GraphQL API provides opportunity to define interactions based on solutions and not endpoints sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
69. @bdougieYO all contributors in x repos
70. What is missing in the GraphQL API @bdougieYO the GitHub API is constantly getting new interactions @bdougieYO @bdougieYO @bdougieYO @bdougieYO
71. Checks API
72. Checks API: Sophisticated feedback @bdougieYO @bdougieYO
73. @bdougieYO @bdougieYO GitHub App: TravisCI • Test and Deploy with Confidence.
74. @bdougieYO @bdougieYO Checks share more information
75. “Check on it” pull request @bdougieYO @bdougieYO
76. @bdougieYO @bdougieYO github.com/apps/linter-alex
77. @bdougieYO @bdougieYO New Checks tab in the UI
78. @bdougieYO @bdougieYO Checks dashboard provides more sophisticated feedback for the developer
79. @bdougieYO @bdougieYO Checks dashboard provides more sophisticated feedback for the developer
80. @bdougieYO @bdougieYO
81. What is missing in the GraphQL API @bdougieYO You can build this for your GraphQL workflow @bdougieYO @bdougieYO @bdougieYO @bdougieYO
82. @bdougieYO @bdougieYO graphql-doctor
83. @bdougieYO @bdougieYO apollo-tooling
84. the Checks API is currently in developer preview sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO
85. sandwich.netlify.com @bdougieYO @bdougieYO @bdougieYO @bdougieYO the Checks API will not work in the explorer
86. @bdougieYO @bdougieYO https://www.graphqlbin.com
87. You can sample GraphQL today by using your own GitHub data @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO
88. Use the GraphQL Explorer to sample @bdougieYO sandwich.netlify.com @bdougieYO @bdougieYO
89. @bdougieYO @bdougieYO https://github.community
90. @bdougieYO developer.github.com/changelog @bdougieYO @bdougieYO @bdougieYO @bdougieYO
91. @bdougieYO