sendgrid documentation & open source projects
DESCRIPTION
TRANSCRIPT
![Page 2: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/2.jpg)
SendGridDocumentation& Open Source Projects
![Page 3: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/3.jpg)
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights Reserved
Why Documentation MattersProgrammableWeb.com API Survey Results
![Page 4: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/4.jpg)
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights Reserved
What Documentation Does
Reduce Support Tickets
Developers Self Serve
Establishes Credibility
![Page 5: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/5.jpg)
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights Reserved
API Workshop
Test the API from browser. No code. !New version coming soon!
![Page 6: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/6.jpg)
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights Reserved
Documentation Is Not Easy
• We are on our third version of documentation. The first 2 were bad.
• It’s a big job. We’re now hiring a person to manage it full time.
• Things are constantly changing
![Page 7: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/7.jpg)
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights Reserved
What Makes Sustainable Documentation?
• Change tracking / version control
• Ease of deploying changes
• Maintainability of platform
• Smart constraints
• Smart defaults
• Ease of editing content
• Defined structure
• These are a lot of the same things that make code sustainable.
!
![Page 8: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/8.jpg)
!8
![Page 9: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/9.jpg)
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights Reserved
Open Source Libraries
PHP Node.js Perl Python
https://github.com/sendgrid/
C# Obj-C Go Java
![Page 10: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/10.jpg)
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights Reserved
Most Popular Libraries
PHP C# Python Node.js
Based on views on Github over the last 2 weeks
![Page 11: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/11.jpg)
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights Reserved
Why Have Open Source Libraries?
• Reduce the amount of work it takes for new users to get started
• Developers like package managers such as npm, nuget, rubygems
• Provides example implementations even if devs don’t use them
• Lets us provide smart defaults — e.g. Web API instead of SMTP
• If we don’t build them, someone will. But we get the questions!
• It’s fun 😊
![Page 12: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/12.jpg)
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights Reserved
Not Just API Wrappers
• Our documentation is open source! github.com/sendgrid/docs
• New newsletter subscription widget is also open source
• We’re trying to open source more projects as well
![Page 13: SendGrid documentation & open source projects](https://reader033.vdocuments.site/reader033/viewer/2022051412/54b5146e4a7959fd6d8b48c8/html5/thumbnails/13.jpg)
Thank you !!