At Microsoft Azure API Management, we took up a challenge of building the next generation developer portal for thousands of our customers. We distilled the essence of developer portals by rethinking their purpose, collecting customers’ feedback, and researching the trends and available solutions. Then, we built our new developer portal based on these findings. In this session you will hear the lessons we learned. You will understand why and how to account for the six principles of a modern developer portal: - Scale and simplicity. How can we serve tens of thousands of concurrent users across the globe? - Roles. How can we be inclusive and create best possible experience for designers, content editors, and developers? - Intent abstraction. How can we abstract the content and look of the portal from its codebase and ensure safety of updates? - Automation and dev-ops. How can we script and automate management of the portal? - Look and feel. How can we incorporate the latest design trends and craft a remarkable web experience for API consumers? - Open source. How can we make the portal publicly available?

2. Six Five

3. Six Five Six

10. Principle #1

12. Data
endpoint
API gateway
endpoint
Static files
API
Management
data
API Management
1
2
Portal
endpoint

13. Principle #2

18. Principle #3

20. Management
endpoint
API gateway
endpoint
Static files
API
Management
data
Portal data
Publishing
worker
Portal code
API
Management
1
23
2

21. Principle #4

24. Principle #5

27. Principle #6

32. #1
#2
#3
#4
#5
#6
@