Contenu connexe
Similaire à SendGrid documentation & open source projects
Similaire à SendGrid documentation & open source projects (20)
SendGrid documentation & open source projects
- 5. API Workshop
Test the API
from browser.
No code.
!
New version
coming soon!
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights
Reserved
- 6. 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
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights
Reserved
- 7. 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.
!
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights
Reserved
- 11. 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 😊
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights
Reserved
- 12. 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
Copyright © KOZO KEIKAKU ENGINEERING Inc. All Rights
Reserved