Documentation By Humans For Humans - Discussion With Polina Zaichkina And Max Clayton Clowes API The Docs podcast

24:42

Episode Notes [01:14] Unexpected Email from Employer [05:49] The Deferred Resignation Program [06:34] Initial Reactions and Concerns [08:01] Evaluating the Offer [08:21] Enhanced Standards of Conduct [08:55] Personal Reflections and Concerns [12:21] Seeking Advice and Making a Decision [13:01] Option One: Do Not Resign [14:56] Option Two: Resign [16:44] Insights from Conversations [21:30] Making The Decision [23:51] Final Thoughts and Gratitude Resources Mentioned Sebastian Junger The Soul of Shame by Curt Thompson Donald Trump Elon Musk Steve Bannon Russell Vought Derek Sivers Sumner Crenshaw Brian Fretwell at Finding Good Chad Littlefield The Thought Leaders Practice by Matt Church Simon Cowell Beauty Pill Producer Ben Ford Questions Asked Is it legitimate, and can it be trusted? How are you feeling? What questions come to your mind? Where does your mind go? Are you seeking safety? Would this have been an adrenaline rush as you raced to send the resignation response? What an "enhanced standard" regarding loyalty and trustworthiness was? What are these new "enhanced standards?" Are they beyond what my Constitutional oath requires? If I don't resign, how bright will the target on my back glow? My leadership has supported all my work, but would termination direction come from higher up the chain of command? What would you recommend if we talked over coffee? What questions would you ask? How would you use listening? How would you use silence? How is this scenario playing out in your mind and body? What is coming to the surface for you? How might that influence what you are about to say to me? What are the chances of my name popping on a list and getting fired? How about the chances of being part of an official Reduction in Force and early retirement? Would the administration make a better offer? What do I know about the pending job market? What did I expect the workplace to be like and did I want to be there as the contractions took place? Will the administration pay me through the end of September or will they renege? Can I sufficiently build the Curated Questions business to transition by 1 October? - Do I have the faith or confidence to step into this future as a sole practitioner and grow Curated Questions into all I envisioned? Was this purpose calling? What would I expect the job market to look like at the end of summer if I hadn't developed the income streams to maintain our lifestyle? What is your recommendation? Did it change from your initial recommendation? Where in your body are you feeling the uncertainty? Are you processing this scenario in parallel with your decision as if you had received the email? What additional questions should I have considered? Who else should I have consulted with? How would you have changed my risk rating? What is the correct length of the pregnant pause before making an important announcement? What processes would you use in my circumstance, and what would be different? What questions are at the top of your list to get to a decision? Who would be the members of your pantheon you would counsel with to gain clarity? Apart from the heady analysis, what other key practices would you include in your journey through a similar situation?…

API The Docs Podcast »
Documentation by humans for humans - Discussion with Polina Zaichkina and Max Clayton Clowes

about a year ago 43:21

MP3•Episode home

How do you get people on board when you shift to a new tool or a new approach? Even if the value proposition is clear, it might be a challenge to create a practice out of the change.

In this episode of API The Docs, Polina Zaichkina (Senior technical writer at Codat) and Max Clayton Cowes (Product director for experience at Codat) share insights about building a culture of participation around documentation and achieving internal enablement.

56 episodes

#Tech #API The Docs

Documentation by humans for humans - Discussion with Polina Zaichkina and Max Clayton Clowes

API The Docs Podcast

published about a year ago

MP3•Episode home

How do you get people on board when you shift to a new tool or a new approach? Even if the value proposition is clear, it might be a challenge to create a practice out of the change.

56 episodes

#Tech #API The Docs

Semua episod

1
Documentation by humans for humans - Discussion with Polina Zaichkina and Max Clayton Clowes 43:21

35 weeks ago43:21

43:21

How do you get people on board when you shift to a new tool or a new approach? Even if the value proposition is clear, it might be a challenge to create a practice out of the change. In this episode of API The Docs, Polina Zaichkina (Senior technical writer at Codat) and Max Clayton Cowes (Product director for experience at Codat) share insights about building a culture of participation around documentation and achieving internal enablement.…

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

37 weeks ago50:38

50:38

In this episode, Naomi Pentrel and Andrew Feierabend share their journey of revamping Viam’s robotics APIs documentation. They discuss the benefits of sitting down with actual users in well-structured interview sessions with specific scripts and tasks. Learn about their approach to user research, their team’s collaborative methodology for achieving daily usability wins, mentoring, and implementing larger-scale changes like automation. And it all started with a smart cat feeder!…

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

38 weeks ago56:46

56:46

Byrne Reese had the opportunity to build a number of developer programs over the years. In this episode, he explains his unique Developer Pyramid framework which he uses as a guide to build a successful and scalable developer program now at RingCentral. He also dives into his passion for board games and how it influences his approach to documentation, and explores the Workflow Builder tool that redefines building on the RingCentral platform. Tune in for all the details!…

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

47 weeks ago27:30

27:30

When it comes to learning Git, it can be daunting to navigate the plethora of learning resources out there. Recognising the need for a visually engaging all-levels experience, Anna Skoulikari (JetBrains) decided to write her own self-study book to help learners along the way.

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

50 weeks ago25:39

25:39

"Key results are the things you're going to do to move that number. Here's the thing where most people spin out. There should be a break mechanism on the things that you're doing […] a culture of experimentation, and objective critique around 'Is this the right thing to be doing?” Welcome back to our two parts episode with Rachel Lee Nabors, we continue with talking about developer portal stakeholders and your metrics based approach.…

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

50 weeks ago23:37

23:37

"You can always tell when it's a novice writer or a writer and an artist who are in bad relation because there will be blocks of text everywhere explaining how the character is feeling […] There's a delicate balance to be struck and it's the same with code.” Welcome Rachel Lee Nabors, one of the creators behind the grand award-winning react.dev portal where all 600+ code examples are manipulable, and in each section’s "code challenges," learners are encouraged to fix broken examples by following clues left by the core team.…

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

51 weeks ago44:35

44:35

Drawing from her role as a wayfinder, Claire Waters (Senior Manager – Product Content Experience, Cloudflare) shares her team’s using the COIN methodology for embracing AI tools as a team, and how they engage in low-stakes AI challenges to foster familiarity and comfort with AI technologies.

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

1 year ago49:23

49:23

You need docs and headspace when a well-oiled system inevitably throws a flat tire. With Dan Grabski we talked from car racing through tech execs mediating at Burning Man, forest fire incident management systems and early expectations setting all the way to API docs and back again.

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

1 year ago36:02

36:02

Technical writers walk a tricky tightrope between delivering accurate technical information and making it comprehensible for a wide range of users with varying levels of technical experience. In this episode, Ryan Young (Technical writer at Stripe) shares his thoughts on bridging the gap between different content layers and writing for humans in a digital world.…

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

1 year ago16:34

16:34

How can one make their devportal accessible and useful at the same time? What can devportal owners do to support inclusive design? We were honored to ask Susanna Laurin (Certified Professional in Accessibility Core Competencies, G3ict and IAAP Representative to the EU) about these questions in 2023’s DevPortal Awards framework. As she highlighted, developer portals were a new field for her, and she saw many angles to approach accessibility. We are happy to share Susanna’s remarks and suggestions with you.Further resources: Best Developer Portals 2023 DevPortal Awards 2023 Jury Interview…

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

1 year ago22:10

22:10

The API The Docs Podcast brings you a Special Edition series with insights from the 2023 DevPortal Awards. Each year, the DevPortal Awards seeks the most outstanding solutions with the help of experienced jurors, who are volunteers with extensive knowledge of API programs, developer portals, and API documentation. In the Special Edition series, we share interviews with the jurors which were recorded during the online Awards Gala events in November, 2023. How can developer portals incorporate gamification into their workflows? How do jurors Anne Gentle (Developer Relations Leader at Cisco DevNet), Bob Watson (Senior Technical Writer), and Michael Richardson (Advanced Software Engineering Manager at Kroger) see the importance of user experience research and design? In 2023, the DevPortal Awards jury members discussed the possibilities, and their remarks could help to create a better user experience for devportals. We are glad to share the episode with you. Further resources: Best Developer Portals 2023 DevPortal Awards 2023 Jury Interview…

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

1 year ago28:09

28:09

The API The Docs Podcast brings you a Special Edition series with insights from the 2023 DevPortal Awards. Each year, the DevPortal Awards seeks the most outstanding solutions with the help of experienced jurors, who are volunteers with extensive knowledge of API programs, developer portals, and API documentation. In the Special Edition series, we share interviews with the jurors which were recorded during the online Awards Gala events in November, 2023. What could be the similarities between Choose Your Own Adventure games and developer portals? Is it possible to reach that level of interactivity to interlocking journeys? In 2023, the DevPortal Awards jury members discussed a few possibilities that could be more than sci-fi. We are happy to share the interviews with you. In this episode, you hear insights from Kruno Golubić (Technical Writer at Memgraph), Marco Spinello (Senior Technical Writer at sanity.io), Richard Smedley (Principal Technical Writer at Couchbase), and Ryan Clifford (Platform Group Product Manager at Spendesk). Further resources: Best Developer Portals 2023 DevPortal Awards 2023 Jury Interview…

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

1 year ago18:40

18:40

The API The Docs Podcast brings you a Special Edition series with insights from the 2023 DevPortal Awards. Each year, the DevPortal Awards seeks the most outstanding solutions with the help of experienced jurors, who are volunteers with extensive knowledge of API programs, developer portals, and API documentation. In the Special Edition series, we share interviews with the jurors which were recorded during the online Awards Gala events in November, 2023. If everything would be possible, what could be the future of developer portals? What aspects do experts welcome, and what elements would be better to leave behind? In 2023, the DevPortal Awards jury members shared their insights with us. We are honored to bring the interviews to you. In this episode, you can learn from DevPortal Awards jurors Chris Bush (Lead Developer Educator at MongoDB), Fabrizio Ferri-Benedetti (Principal Technical Writer at Splunk), and Koichi Shiroma (Senior Product Development). Further resources: Best Developer Portals 2023 DevPortal Awards 2023 Jury Interview…

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

1 year ago36:32

36:32

Connected to both customers and internal teams, customer success is a powerful source of valuable information throughout the entire feedback loop. In this episode, Charlie Edwards (Customer Success Manager at CAE Technologies Limited) explains how the feedback from customer success teams contributes to the comprehensive improvement of products. The API The Docs Podcast was brought to you by Pronovix. https://pronovix.com/…

1
Building empathy with a beginner’s mindset - Discussion with Adrienne Braganza Tacke 49:46

1 year ago49:46