UploadLanguage (EN)Support
BusinessMobileSocial MediaMarketingTechnologyArt & PhotosCareerDesignEducationPresentations & Public SpeakingGovernment & NonprofitHealthcareInternetLawLeadership & ManagementAutomotiveEngineeringSoftwareRecruiting & HRRetailSalesServicesScienceSmall Business & EntrepreneurshipFoodEnvironmentEconomy & FinanceData & AnalyticsInvestor RelationsSportsSpiritualNews & PoliticsTravelSelf ImprovementReal EstateEntertainment & HumorHealth & MedicineDevices & HardwareLifestyle
Upload
Sign in
Gilad Shoham, profile picture
Uploaded byGilad Shoham
PDF, PPTX118 views

GraphQL - IL - Accelerate your GraphQL adoption using bit

The document discusses strategies for enhancing the adoption of a public API using GraphQL, emphasizing the importance of simplifying documentation and providing relevant examples for developers. It highlights the challenges of information overload, connection issues in client contexts, and the need for effective integration flows. The proposed solution includes a centralized repository for API examples, allowing quick modifications and redistributions to address developers' needs.

Software◦
Download as PDF, PPTX
1 / 15
2 / 15
3 / 15
4 / 15
5 / 15
6 / 15
7 / 15
8 / 15
9 / 15
10 / 15
11 / 15
12 / 15
13 / 15
14 / 15
15 / 15
Accelerate Your GraphQL Adoption with Bit
Gilad Shoham Dev & Open Source Leader @ Bit shoham.gilad@gmail.com • gilad@cocycles.com
Goal Increase Adoption of Your Public API
How Make it Easy and Simple to Consume Your API
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
Challenges Flexible Yet simple design Versions Consistency & Backward Compatibility Writing Documentation Create Examples Docs and Tests Make it Easy to Find Relevant Examples
Documentation Hate to Write Docs Love to Code API Developers Hate Reading Docs Love to Read Code Consumer’s Developers
Using Examples What Consumers Really Want? Use Examples as Basis for Working with the API Use Examples in your own Context or Project
Examples - Options GitHub GraphQL API GraphQL API v4 on Github Developer Postman
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)
Meet Bit Codebase Virtualization Component Environment Virtual API Component Discoverability
Bit GraphQL GraphQL is Hierarchical (Infra/Fragments/Interfaces/Queries/Client) Composable by Nature Modify and use any Query/Component Individually from every Context
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
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
Q & A