The full video can be found here:
https://youtu.be/G1-cum8xYzU (Hebrew version)
This talk is about making the GraphQL consumer happier, which will serve our goal as publishers, to increase adoption.
During this talk, I’ll describe a way for an organization to use components as a way to accelerate its GraphQL adoption. This GraphQL can be a public to everyone or public to the organization only.
I’ll describe the current problems with publishing and adopting APIs, and demonstrate a live demo of integrating GitHub GraphQL into my own project in few minutes by using components pre built by the publisher, without the need of reading any documentation (which as developers we hate doing).
5. Integration Flow
Integration
needed
Go Over the
Docs
Trying Out API
on External
Environment
POC with API on
My Own Project
Introduce a Real
Use Case
Share with
Other Projects in
my Organisation
My Project +
GitHub in
Production
New/Changed Requirements
Bit
6. Challenges
Flexible Yet simple design
Versions Consistency &
Backward Compatibility
Writing Documentation
Create Examples
Docs and Tests
Make it Easy to Find
Relevant Examples
7. Documentation
Hate to Write Docs
Love to Code
API
Developers
Hate Reading Docs
Love to Read Code
Consumer’s
Developers
10. Examples - Problems
Information Overload on Docs Site
Requires Copy/Paste to Consumer’s Project
Query is not Connected to Client
(React/Angular/Apollo)
Can’t Run the Code Live in my Context
Can’t Change the Code and Republish (NPM)
File System Constraints (NPM)
12. Bit GraphQL
GraphQL is Hierarchical
(Infra/Fragments/Interfaces/Queries/Client)
Composable by Nature
Modify and use any Query/Component
Individually from every Context
13. Integration Flow + Bit
Integration
needed
Go Over the
Docs
Trying Out API
on External
Environment
POC with API on
My Own Project
Introduce a Real
Use Case
Share with
Other Projects in
my Organisation
My Project +
GitHub in
Production
New/Changed Requirements
Bit
Bit Import Bit Modify Bit Export
14. Summary
One Stopshop for all API Examples
Use CMD to Immediately Start Using
Examples in your Own Context
Modify and Republish
Examples in Seconds
Advanced Search Engine
to Find the Exact Example
Writing and Reading Docs Code