התחל במצב לא מקוון עם האפליקציה Player FM !
Source code access, consistency: some ingredients of Adyen's API program
Manage episode 317242263 series 2922116
Interview with Ruby Batallones, Technical Writer at Adyen and Aleksei Akimov, Head of API at Adyen
Involve your technical writers already from the API design discussions: this can help ensure a consistent user experience across all APIs, and in finding the middle ground between the usability requirements and the architecture requirements.
At Adyen, technical writers have the ways and means to add and maintain the descriptions in the source code, they can make sure that all the bits and pieces are linked together and enough context is provided everywhere. This practice brought that techwriters habitually use the developer tools as well, and have a deeper technical understanding of the API, which in turn enables better communications earlier on.
The recently open sourced Adyen Explorer and documentation won 2 prizes at the 2019 DevPortal Awards: Best API Reference Documentation and Best Decision Maker Documentation.
Our guests are Ruby Batallones Technical Writer at Adyen, former solution architect and implementation engineer, and Aleksei Akimov, who started his career in software development, then added technical writing, was leading the Documentation & Developer Experience team and is now responsible for Adyen API design, strategy, and governance.
The hosts are Laura Vass (Editor of Developer Portals Newsletter, Co-Founder of Pronovix) and Anett Pozsár (Senior Technical Writer, Pronovix).
56 פרקים
Manage episode 317242263 series 2922116
Interview with Ruby Batallones, Technical Writer at Adyen and Aleksei Akimov, Head of API at Adyen
Involve your technical writers already from the API design discussions: this can help ensure a consistent user experience across all APIs, and in finding the middle ground between the usability requirements and the architecture requirements.
At Adyen, technical writers have the ways and means to add and maintain the descriptions in the source code, they can make sure that all the bits and pieces are linked together and enough context is provided everywhere. This practice brought that techwriters habitually use the developer tools as well, and have a deeper technical understanding of the API, which in turn enables better communications earlier on.
The recently open sourced Adyen Explorer and documentation won 2 prizes at the 2019 DevPortal Awards: Best API Reference Documentation and Best Decision Maker Documentation.
Our guests are Ruby Batallones Technical Writer at Adyen, former solution architect and implementation engineer, and Aleksei Akimov, who started his career in software development, then added technical writing, was leading the Documentation & Developer Experience team and is now responsible for Adyen API design, strategy, and governance.
The hosts are Laura Vass (Editor of Developer Portals Newsletter, Co-Founder of Pronovix) and Anett Pozsár (Senior Technical Writer, Pronovix).
56 פרקים
כל הפרקים
×
1 Documentation by humans for humans - Discussion with Polina Zaichkina and Max Clayton Clowes 43:21

1 From Inconsistent to Award-winning Docs - Conversation with Naomi Pentrel & Andrew Feierabend 50:38

1 The Secret Sauce of Developer Programs: A Conversation with Byrne Reese 56:46

1 Teaching and Learning Git - Discussion with Anna Skoulikari 27:30

1 Install ways to check on the overall health of the portal - Conversation with Rachel Lee Nabors 25:39

1 React.dev and storyboarding with Rachel Lee Nabors 23:37

1 On the management track - conversation with Claire Waters 44:35

1 The zen of resilience - Discussion with Dan Grabski 49:23

1 Writing with humans in mind - Discussion with Ryan Young 36:02

1 DevPortal Awards Jury Interview - Special Edition Part 4 16:34

1 DevPortal Awards Jury Interview - Special Edition Part 3 22:10

1 DevPortal Awards Jury Interview - Special Edition Part 2 28:09

1 DevPortal Awards Jury Interview - Special Edition Part 1 18:40

1 Harnessing the power of customer success - Discussion with Charlie Edwards 36:32

1 Building empathy with a beginner’s mindset - Discussion with Adrienne Braganza Tacke 49:46
ברוכים הבאים אל Player FM!
Player FM סורק את האינטרנט עבור פודקאסטים באיכות גבוהה בשבילכם כדי שתהנו מהם כרגע. זה יישום הפודקאסט הטוב ביותר והוא עובד על אנדרואיד, iPhone ואינטרנט. הירשמו לסנכרון מנויים במכשירים שונים.