Let's Talk Docs   /     Fabrizio Ferri-Benedetti

Description

Sponsored by Document Write · EthicalAds · Sourcegraph Panelists Portia Burton | Eric Holscher Guest Fabrizio Ferri-Benedetti Show Notes Hello and welcome to Let’s Talk Docs, the show where we talk about documentation, open source, tech, and the intersection of the three. Today, our special guest is Fabrizio Benedetti, who’s a Senior Staff Technical Writer at Splunk, and previously was a technical journalist and studied psychology. Fabrizio takes us through his journey of technical writing and shares some helpful tips if becoming a technical writer interests you. We also find out more about Fabrizio’s “Columbo Technique for Technical Writers,” he explains docs-as-code, and we learn about the children’s story he’s doing on OpenTelemetry. Go ahead and download this episode not to find out more! [00:00:43] Fabrizio tells us how he got into technical writing and the path that led him to where he’s at in his career. [00:06:55] We learn more about the Columbo Technique for technical writers. [00:09:24] Portia wonders if junior technical writers struggle with talking to the engineer, and Fabry tells us some cliché questions that newer technical writers might ask. [00:12:14] Fabrizio explains docs-as-code. [00:17:28] We find out some skills Fabrizio picked up as a tech journalist that he still uses today. [00:20:54] Fabrizio shares some advice if you’re interested in becoming a technical writer. [00:25:46] We hear Fabrizio explain about improving the tool chain. [00:31:31] Fabrizio talks about working on a children’s story on OpenTelemetry. [00:34:40] Find out where you can follow Fabrizio online. Quotes [00:03:57] “With the transition to tech writing, there’s something about precision in scientific language.” [00:07:29] “I was trying to think of something that could capture the essence of what I do on a daily basis and this image of the detective came to my mind, and I immediately thought of Columbo.” [00:13:59] “You can do docs-as-code with pretty much any markup language.” [00:19:57] “It’s really hard to document something that doesn’t make sense.” [00:21:14] “Some general tips I would say is to start building your own website which could also contain your own portfolio.” [00:26:04] “If I saw the resume of a technical writer wannabe, former Python developer that created a small script to convert tables between formats flawlessly, I would hire that guy.” Links SustainOSS (https://sustainoss.org/) SustainOSS Twitter (https://twitter.com/SustainOSS?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Eauthor) SustainOSS Discourse (https://discourse.sustainoss.org/) Portia Burton Twitter (https://mobile.twitter.com/agencycecil) Eric Holscher Twitter (https://twitter.com/ericholscher) Fabrizio Ferri-Benedetti Twitter (https://twitter.com/remoquete) Fabrizio Ferri-Benedetti LinkedIn (https://www.linkedin.com/in/fabrizioferri/) Fabrizio Ferri-Benedetti Blog (https://passo.uno/) Fabrizio Ferri-Benedetti GitHub (https://github.com/theletterf) Splunk (https://www.splunk.com/) Columbo Technique (https://passo.uno/the-columbo-technique-for-technical-writers/) OpenTelemetry (https://opentelemetry.io/) Credits Executive Produced by Justin Dorfman (https://www.justindorfman.com/) Edited by Paul M. Bahr at Peachtree Sound (https://www.peachtreesound.com/) Show notes by DeAnn Bahr at Peachtree Sound (https://www.peachtreesound.com/) Cover art by Eriol Fox (https://erioldoesdesign.github.io/) Special Guest: Fabrizio Ferri-Benedetti.

Summary


Sponsored by
Document Write · EthicalAds · Sourcegraph

Panelists

Portia Burton | Eric Holscher

Guest

Fabrizio Ferri-Benedetti

Show Notes

Hello and welcome to Let’s Talk Docs, the show where we talk about documentation, open source, tech, and the intersection of the three. Today, our special guest is Fabrizio Benedetti, who’s a Senior Staff Technical Writer at Splunk, and previously was a technical journalist and studied psychology. Fabrizio takes us through his journey of technical writing and shares some helpful tips if becoming a technical writer interests you. We also find out more about Fabrizio’s “Columbo Technique for Technical Writers,” he explains docs-as-code, and we learn about the children’s story he’s doing on OpenTelemetry. Go ahead and download this episode not to find out more!

[00:00:43] Fabrizio tells us how he got into technical writing and the path that led him to where he’s at in his career.

[00:06:55] We learn more about the Columbo Technique for technical writers.

[00:09:24] Portia wonders if junior technical writers struggle with talking to the engineer, and Fabry tells us some cliché questions that newer technical writers might ask.

[00:12:14] Fabrizio explains docs-as-code.

[00:17:28] We find out some skills Fabrizio picked up as a tech journalist that he still uses today.

[00:20:54] Fabrizio shares some advice if you’re interested in becoming a technical writer.

[00:25:46] We hear Fabrizio explain about improving the tool chain.

[00:31:31] Fabrizio talks about working on a children’s story on OpenTelemetry.

[00:34:40] Find out where you can follow Fabrizio online.

Quotes

[00:03:57] “With the transition to tech writing, there’s something about precision in scientific language.”

[00:07:29] “I was trying to think of something that could capture the essence of what I do on a daily basis and this image of the detective came to my mind, and I immediately thought of Columbo.”

[00:13:59] “You can do docs-as-code with pretty much any markup language.”

[00:19:57] “It’s really hard to document something that doesn’t make sense.”

[00:21:14] “Some general tips I would say is to start building your own website which could also contain your own portfolio.”

[00:26:04] “If I saw the resume of a technical writer wannabe, former Python developer that created a small script to convert tables between formats flawlessly, I would hire that guy.”

Links

SustainOSS

SustainOSS Twitter

SustainOSS Discourse

Portia Burton Twitter

Eric Holscher Twitter

Fabrizio Ferri-Benedetti Twitter

Fabrizio Ferri-Benedetti LinkedIn

Fabrizio Ferri-Benedetti Blog

Fabrizio Ferri-Benedetti GitHub

Splunk

Columbo Technique

OpenTelemetry

Credits

Special Guest: Fabrizio Ferri-Benedetti.

Sponsored By:

Subtitle
Fabrizio Benedetti is a Senior Staff Technical Writer at Splunk, and previously was a technical journalist and studied psychology. Fabrizio takes us through his journey of technical writing and shares some helpful tips if becoming a technical writer int
Duration
35:16
Publishing date
2022-02-27 12:00
Link
https://ltd-podcast.sustainoss.org/3
Contributors
  SustainOSS
author  
Enclosures
https://chrt.fm/track/28DGC9/aphid.fireside.fm/d/1437767933/98ecf3aa-9157-4278-a770-0bae0b9b7d99/3de684a7-e7cd-4d88-a13a-7b2fde4c4214.mp3
audio/mpeg

Shownotes


Sponsored by
Document Write · EthicalAds · Sourcegraph

Panelists

Portia Burton | Eric Holscher

Guest

Fabrizio Ferri-Benedetti

Show Notes

Hello and welcome to Let’s Talk Docs, the show where we talk about documentation, open source, tech, and the intersection of the three. Today, our special guest is Fabrizio Benedetti, who’s a Senior Staff Technical Writer at Splunk, and previously was a technical journalist and studied psychology. Fabrizio takes us through his journey of technical writing and shares some helpful tips if becoming a technical writer interests you. We also find out more about Fabrizio’s “Columbo Technique for Technical Writers,” he explains docs-as-code, and we learn about the children’s story he’s doing on OpenTelemetry. Go ahead and download this episode not to find out more!

[00:00:43] Fabrizio tells us how he got into technical writing and the path that led him to where he’s at in his career.

[00:06:55] We learn more about the Columbo Technique for technical writers.

[00:09:24] Portia wonders if junior technical writers struggle with talking to the engineer, and Fabry tells us some cliché questions that newer technical writers might ask.

[00:12:14] Fabrizio explains docs-as-code.

[00:17:28] We find out some skills Fabrizio picked up as a tech journalist that he still uses today.

[00:20:54] Fabrizio shares some advice if you’re interested in becoming a technical writer.

[00:25:46] We hear Fabrizio explain about improving the tool chain.

[00:31:31] Fabrizio talks about working on a children’s story on OpenTelemetry.

[00:34:40] Find out where you can follow Fabrizio online.

Quotes

[00:03:57] “With the transition to tech writing, there’s something about precision in scientific language.”

[00:07:29] “I was trying to think of something that could capture the essence of what I do on a daily basis and this image of the detective came to my mind, and I immediately thought of Columbo.”

[00:13:59] “You can do docs-as-code with pretty much any markup language.”

[00:19:57] “It’s really hard to document something that doesn’t make sense.”

[00:21:14] “Some general tips I would say is to start building your own website which could also contain your own portfolio.”

[00:26:04] “If I saw the resume of a technical writer wannabe, former Python developer that created a small script to convert tables between formats flawlessly, I would hire that guy.”

Links

SustainOSS

SustainOSS Twitter

SustainOSS Discourse

Portia Burton Twitter

Eric Holscher Twitter

Fabrizio Ferri-Benedetti Twitter

Fabrizio Ferri-Benedetti LinkedIn

Fabrizio Ferri-Benedetti Blog

Fabrizio Ferri-Benedetti GitHub

Splunk

Columbo Technique

OpenTelemetry

Credits

Special Guest: Fabrizio Ferri-Benedetti.

Sponsored By: