App preview

The Manu<script>

The podcast where we delve into the intersection of writing and the development of technology products.

Episodes

A full list of the episodes we published so far. Enjoy! =)



Ep. 25: Backstage, Q&A and our future

Published on: August 18, 2021

Welcome to quite a different episode than what we’re used to. We’ll have a Q&A about the show, share some backstage stories, special projects like Pupila Talk, and talk about the future of the show. Get to know some of our guests today:
Lucas Costa's Linkedin

Ana Carolina do Carmo's Linkedin

Babi Pinheiro's Linkedin and Portfolio

Karla Luz's Linkedin and Portfolio

Ep. 24: Case Study: Release Notes

Published on: July 30, 2021

In this episode we interviewed Beatriz Guerreiro, fellow tech writer at VTEX, to talk about release notes, and the process of implementing them at VTEX. Bia graduated in International Relations at Universidade Federal Fluminense, in Rio de Janeiro, Brazil, and before joining VTEX she worked at IBM in the Latin American HR. And we’re trying out a different kind of episode. On the last couple of weeks we came to the conclusion that it would be really cool to share with you a recent challenge we faced at VTEX involving release notes. We wanted to share how it went down and what we learned in the process. And it brought to my mind that maybe this could be a recurrent theme on the show. What if we had themed episodes with case studies of projects that different people lead? Tell us what you think! Links mentioned today:
Beatriz Guerreiro

Flash forward podcast

Beyond Predictable podcast

Ep. 23: Launching a streaming platform

Published on: June 30, 2021

In this episode we interviewed Maria Beatriz Vilela, marketing specialist at Imovision, the film distributor. We’ll be covering a digital product that has been on my wish list for ages: streaming platforms! Maria Beatriz led the launch of Imovision’s first streaming platform, so we’ll talk specifically about film distribution, and how marketing content applies to this media. We dive deep about the insides of the movie industry, and how tech writing can be a part of other professionals' day to day - even though they are not aware of it!

Ep. 22: Videogames! And how words are part of the experience

Published on: June 15, 2021

In this episode, we interviewed Pedro Alecrim, technical writer at Wildlife Studios to talk about games, and how words are part of how users interact with them. We focused our chat on the following topics: Pedro's career and how it feels to work in this industry; game development, and how it differs from regular app's development; community engagement; and finally, the particularities of tech and UX writing in games. Links mentioned:
Game Maker's Toolkit: Should Game Designers Listen to Negative Feedback?

Game Maker's Toolkit: Super Mario 3D World's 4 Step Level Design

Zelda's Walkthrough

Tech Writing Handbook: Dozuki

Videos from Nitroplay, where Pedro was a youtuber

Boardgames and TechWriting

Games mentioned: Assassin's Creed Valhalla, Outfire, Animal Crossing, Legend of Zelda, Zooba, League of Legends Wild rift, Bioshock trilogy, The Witcher 3, Super Mario Bros, Neopets.

Ep. 21: Solving tech problems, hiring tech writers

Published on: June 2, 2021

In this episode, we interviewed Bruno Amui, tech writing lead at VTEX. We covered two main topics: the first one, we like to call “how Bruno performs his tech sorcery” which is basically his analytical approach to solving any problem or bug - which will interest you, even if you don't work with documentation; and secondly, we’ll talk about hiring and training tech writers for roles that demand more technical backgrounds. On the previous episode, we talked about the decisions around platforms and tools that tech writers use to create and host documentation. Listen to part one and two to get the full experience!
Bruno mentions The Nebula Awards, The Hugo Awards and Hackaday blog.

Ep. 20: From building satellites to documentation platforms

Published on: May 25, 2021

In this episode we cover tech writing and documentation platforms and tools. We interviewed Bruno Amui, tech writing lead at VTEX, talking about Bruno's surprising career path, where he jumped from building hardware, robots, and even satellites, to leading a tech writing team at VTEX.
And spoiler alert: this is another episode where the chat was so inspiring that we didn't want to leave anything out, so our next episode will feature the rest of our interview, where we'll cover what we like to call "how Bruno performs his tech sorcery" since he can fix literally any problem or bug that we face. We'll also talk about leading a team of tech writers on our next episode, so stay tuned and listen to both parts to get the full experience.

Ep. 19: Training, mentorship and diversity for writers in tech

Published on: March 30, 2021

In this episode we interview John A Paz, senior content designer at Menlo Security. Our chat with John was so inspiring to us that we just had to share the full conversation with you. And to improve your podcasting experience we split it into two episodes. So today you'll listen to part two, where he dives deep into the reality of the tech market for writers, and how we have a long way until we reach racial equality and inclusion. We also talk about how mentoring and training junior tech writers can be key into transforming lives and the market.
On part one, we explore John’s career, his experience in tech writing at Atlassian and Menlo, illustrated with his real day to day challenges, and how tech writing can be a great entry point for people interested in joining the tech market.

Check out John Paz's website to know more about his work!

Ep. 18: Building a career in Tech Writing

Published on: March 16, 2021

This episode is especially interesting for you, fellow tech writer, or aspiring tech writer, out there in the world. We interview John A Paz, senior content designer at Menlo, and he dives deep into the reality of working in the tech writing market. Our chat with John was so inspiring to us that we just had to share the full conversation with you. And to improve your podcasting experience we split it into two episodes. So today you'll listen to part one, where we explore John’s career, his experience in tech writing at Atlassian and Menlo, illustrated with his real day to day challenges, and how tech writing can be a great entry point for people interested in joining the tech market.

Check out John Paz's website to know more about his work!

Ep. 17 - Technology's impact on journalism and Black Lives Matter

Published on: January 26, 2021

On this episode, we interview Carlisa Johnson, multimedia journalist based in Atlanta. Her work focuses on race and gender politics, specifically highlighting experiences within the African Diaspora. We started things off by talking about Carlisa's career and her experience as a journalist, we also explored the connection between journalism and technology, and finally talked about activism, and her protagonism in the Black Lives Matter movement.


Check out Carlisa's website to know more about her work!

Ep. 16 - Data Science, communication and AI ethics

Published on: January 12, 2021

On this episode, we interview Ayodele Odubela, a Data Scientist and AI Ethicist who believes we should be using tech to make the lives of marginalized people better. We dive deep into the world of Data Science, Machine Learning and AI, and the challenges of communicating data. We also explore how we should bring more ethics and diversity into the field, if we want to create a more equal and just society, especially for underrepresented minorities.

Check out Ayodele's books in the links below:
Uncovering Bias in ML
Getting started in Data Science

Ep. 15 - Art and tech - from physical to digital

Published on: December 15, 2020

This episode is for all the art lovers out there, who are also passionate about tech.

We've interviewed Clare Brooks, who's worked as a creative producer in animation from Universal Studios to Nexus in London, making a move to AR and VR storytelling in Google and Facebook, and finally taking a leap into the art world. Now she's a producer at Google Arts and Culture Lab, experimenting with AI and machine learning.

She talks about the challenges of bringing an artwork from physical to digital and vice versa, the impact COVID-19 has brought to her industry and how we consume art, and also the role of writing and communication in all of it.

Ep. 14 - mini episode: Newsletters and book recommendations

Published on: December 02, 2020

And today we're breaking the rules. This is a special, surprise, mini episode for you.

So last week we talked to Beatriz Guarezi about breaking the rules of content creation through newsletters. She’s a Senior Brand Manager at Liv Up, inhabiting the universe of brands since 2013 through research, consulting and content creation. She's the author and creator of Bits to Brands, a weekly newsletter that unites the fields of brand and technology, reaching thousands of professionals throughout Brazil.

And as you know, in the Manuscript we have a block where we ask our guests what are they currently reading, and also their book recommendations for the episode's theme. And Beatriz, being the incredible curator that she is, has given you a gift: here you can find links for this massive booklist she has curated over the years. And to celebrate this gift, we decided to keep our chat with her about books, and quarantining in a separate episode. So listen to that bit of our interview in this special, mini episode, and don't forget to check out the links below to collect your gift!

Book lists:
Saia da internet e vá ler um livro
Estante coletiva

For our non-portuguese-speaking listeners: although the articles above are in Portuguese, there's an Amazon link to all books cited, so you can purchase the english version.

Ep. 13 - Newsletters, curation & breaking the rules of content creation

Published on: November 17, 2020

In this episode we interviewed Beatriz Guarezi, talking about breaking the rules of content creation through newsletters. She’s a Senior Brand Manager at Liv Up, inhabiting the universe of brands since 2013 through research, consulting and content creation. She's the author and creator of Bits to Brands, a weekly newsletter that unites the fields of brand and technology, reaching thousands of professionals throughout Brazil.

If you're brazilian, or a portuguese speaker, subscribe to Bits to Brands through the link below: https://www.bitstobrands.com/

Ep. 12 - Teaching and Tech Writing - Part 2'

Published on: November 03, 2020

In this episode we chatted with George Brindeiro, who is the head of VTEX's Education team. Our chat was so insightful we didn’t want to keep any details out, so we actually split our conversation into two episodes. On part two we dive deep into our experience with tech writing, illustrating our chat with lots of real cases that happen in our day to day work, our team rituals that make us grow personally and as a team, and how we deal with our documentation challenges. So listen to parts 1 and 2 to get the full experience.

Ep. 11 - Teaching and Tech Writing - Part 1'

Published on: August 05, 2020

In this episode we chatted with George Brindeiro, who is the head of VTEX's Education team. Our chat was so insightful we didn’t want to keep any details out, so we actually split our conversation into two episodes. On part one we talked about how George’s career path brought him into technical writing, how his experience as a teacher reflects on his work today, and our discovery of the technical writing universe.
Part 2 is already available! Listen to both episodes, to get the full experience.

Ep. 10 - UX Writing - beyond 'fixing the words'

Published on: June 30, 2020

In this episode we cover a very special subject for us: UX Writing with Torrey Podmajersky. Torrey's the author of the best-seller book Strategic Writing for UX and is currently a UX writer and content strategy consultant for Google. She's built an inspiring career getting involved in the most varied spaces, from high school teaching, to fiction writing, and content strategy for numerous organizations. We started off by talking about her career, followed by the universe of UX writing itself, and of course, its application in the tech industry and digital products. We close our chat by discussing her amazing book that is definitely a major reference in the field.

We are both from Brazil, and some times a few Brazilian memes or expressions end up slipping past us, during the interviews. To comment on the one at 58:40'':

Whenever brazilians want to say that they joined or started something way before it was hyped, or well developed, we say "when I first came here, everything was just made up of grass/undergrowth". Meaning, nothing was built yet, everything was still green. Any brazilian listeners out there who agree with our translation?

Ep. 9 - Where design, tech and writing meet

Published on: May 25, 2020

In this episode we interviewed Daniel Fosco, Senior Product Designer at Booking.com. Exploring the relationship between design, writing and technology, Daniel shares his perspective on UX design processes, web design practices, as well as the collaboration with tech and UX writers. We balanced our conversation between practical advices for designing developer’s experience, and abstract queries about design principles and typography.

Ep. 8 - 40 countries, 7 languages: localization and global expansion

Published on: May 11, 2020

In this episode we were honoured to interview Larissa Mansur, head of localization and global expansion at Mindvalley. Mindvalley is the world’s leading personal growth platform with 12 million students subscribed, and they have the mission of making their content accessible for 7 different languages. Having lived in more than 8 countries herself, Larissa truly understands the impact of language and culture, and we talk about the power and challenges of localization, and the particularities of it within the tech industry.

Ep. 7 - How to build an organization’s personality with Tone and Voice

Published on: April 27, 2020

In this episode, we had the pleasure of interviewing Mary K. Nielsen, UX Content Strategist at Mailchimp. Balancing philosophical aspects of Tone and Voice, but also giving practical guidance, we discussed how to build a company’s personality inside and outside digital products using this essential writing principle. Mailchimp is definitely a key reference when it comes to Tone and Voice within a company’s communication strategy, and we had a chance to understand how its own T&V was built.

Ep. 6 - Spreading knowledge through writing in the biggest fintech in Latin America

Published on: April 13, 2020

In this episode of The Manuscript, we talk to Paulo Victor, a technical writer currently working for Nubank, the largest fintech in Latin America and one of the most innovative companies in the world. He explores the challenge of deciphering the financial universe for a knowledgeable internal audience, talks about the challenge of being the company’s first tech writer, and addresses the advantages and disadvantages of being a writer with an engineering background.

Ep. 5 - What you didn’t know about innovation (and storytelling)

Published on: March 30, 2020

In this episode, we interview Sarah Arruda, Executive Producer at Tendril Studio. Sarah is a creative producer, experimenting with new media technologies to bring the digital world to life in the physical space. Here she talks about the challenges and benefits of dealing with multidisciplinary projects, the integration of writing, storytelling and technology, the ways she interacts with the tech aspect of innovation, and the boundaries between innovation and creativity.

Ep. 4 - The paths for a writer towards senior positions in tech

Published on: March 16, 2020

Christopher Gales is the Senior Director of Documentation at Splunk. He has more than 20 years of experience in technical communications and engineering program management. In Splunk, he leads a team of 40+ writers, who form one of the best tech comm teams in the industry today. In this episode, he talks about reaching senior levels in a tech writing career, the organization of his team, the importance of customer feedback in our field, how to instill a documentation culture in our companies and what to look for when hiring writers.

Ep. 3 - Focusing on skills to show Tech Writing is not boring

Published on: March 02, 2020

Jacob Moses is the creator of The Not-Boring Tech Writer podcast. In each episode, Jacob covers a new tech writing skill, with the goal of showing tools all of us can use to become better writers and proving this is far from a tedious career. In doing that, he helps to raise awareness about the field and improves the sense of a Tech Writing community.

Ep. 2 - How technical should a tech writer be?

Published on: February 24, 2020

Tom Johnson is a technical writer from California, currently working for Amazon in the Appstore group. He is also the creator of the blog I’d Rather Be Writing, one of the most influential blogs on technical communications today. In this episode, Tom explores how a tech writer should approach the balance between writing expertise and technical knowledge. He also talks about the most common pitfalls in writing API documentation and shares his thoughts on how beginner writers should tackle the challenge of learning to use and document APIs.

Ep. 1 - Every Page is Still Page One

Published on: February 17, 2020

In this episode, we interview Mark Baker who is the author of the book Every Page is Page One. Originally published in 2013, this book has become an absolute classic in the Content Strategy field. In this interview, Mark explains how turning web pages into self-contained topics is the way to make content that serves its purposes and gets found by the users.

The Host

Who is behind the podcast.

Ju graduated in Business and is currently a lead tech writer at VTEX. Previously worked for an animation studio in London and at social impact organisations in Mexico, Brazil and Panama.

Juliana Meyer's photo Juliana Meyer

Stay tuned!

Subscribe to the podcast on your favorite platform.