Company
Date Published
Author
Jarrett Retz
Word count
1648
Language
English
Hacker News points
None

Summary

Developer portals are how developers understand, interact, adopt, monitor, and govern new technologies at the heart of developer portals is a resource such as an API resource cloud resource virtual machines or any other cloud resource. Developer portals facilitate interactions between developers and a resource and help them feel comfortable with resources allowing them to take control of their space. Documentation is a common way to end up on a service's developer portal for the first time and judging the quality of a developer portal can be judged by the quality of the documentation developers examine documentation and calculate the ease of adoption and easier it is developers are more likely to use the service Stripe provides clear documentation for parameters return values code snippets and response objects in addition to offering in-depth examples. Development speed is slowed down if information is not available in the documentation and sample code can also impact development speed some portals offer interactive input components while others may just show a few code snippets as an example code snippets provide a nice starting point for adopting the API resource developer portals also provide support for their products some questions are too complex for the documentation portals offer live chat or email support although some services may offer live chat a common theme with developer portals is independence developers want to be able to solve their problems sometimes the question isn't urgent so portals offer an easy way to open up a support ticket to be answered by email at a later time.