Let's Talk Docs   /     Megan Sullivan

Description

Sponsored by Document Write · EthicalAds · Sourcegraph Panelists Portia Burton | Eric Holscher Guest Megan Sullivan Show Notes Hello and welcome to Let’s Talk Docs! This is our first episode and we’re so happy you’re joining us. On this podcast, we’ll be sharing with you a new concept around documentation and sustainability. We’re going to talk about how you can leverage documentation, how you can leverage content to bring more people, more attention, and more funding to your products. We’ll talk to experts who know how to write content engagingly, interview people who speak about the importance of content having goals, and talk to people who have successfully built projects, used excellent documentation, and used the content as the pillar of their success. Our panelists are Portia Burton, who is the owner of DocumentWrite, and Eric Holscher, who is the Co-Founder of Read the Docs, Write the Docs, EthicalAds, and PyCascades. We are super excited to have as our guest, Megan Sullivan, who is a Developer Educator at Apollo. Megan shares her background and story about studying CS, going into teaching CS courses, and how putting the two together helped her become a more confident professional developer and create a path for others with an educational background. We find out about a manual Megan wrote about herself, what “Being Glue” means, and she shares advice if you’re the person who’s interested in taking this journey similar to what she’s doing in technical writing and education. Go ahead and download this episode now! [00:01:27] We hear what Megan did before specializing in technical documentation. [00:06:16] Megan mentioned teaching people to code when she did the AmeriCorps program, and Portia wonders if she were to go back and design a CS program how would she do it that would be engaging. [00:10:44] Megan shares what inspired her to get into technical writing. [00:14:51] On Megan’s website, she has a page dedicated to accessibility, and she tells us about the manual she wrote about herself and she mentions Steph Smith’s website. [00:16:51] Find out what inspired Megan to publish her manual and share it. [00:18:28] Portia talks about notetaking and “Being Glue,” and asks Megan’s opinion on what she would say about women who want to help out their team but don’t want to be like glue. [00:23:20] We hear Megan’s thoughts on ways she thinks documentation can be taken more seriously, and how can we get people in college to get excited and build that status in the industry to get people excited. [00:27:44] Megan shares some advice if you’re interested in following this kind of path of teaching technical stuff, and she tells us about a great book, Docs for Developers. [00:32:25] We end with some shout-outs and cool things happening that you should check out. Quotes [00:07:40] “There are a lot of different ways that knowing how to code can help you in different industries.” [00:09:02] “Right when I started that program was around the time the movie The Social Network came out, and I thought if this is what being in tech is like I want no part in that.” [00:14:21] “I like trying to figure out how to make things look pretty and I’m not good at it, but I like thinking about that and thinking about accessibility is something I’m really interested in.” [00:23:42] “I think a good way to get people to take documentation seriously is to talk about what’s hard about documentation.” 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?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Eauthor) DocumentWrite (https://documentwrite.dev/about/) Write the Docs (https://www.writethedocs.org/) Read the Docs (https://readthedocs.org/) EthicalAds (https://www.ethicalads.io/) PyCascades (https://2022.pycascades.com/) Megan Sullivan Twitter (https://twitter.com/meganesulli) Megan Sullivan LinkedIn (https://www.linkedin.com/in/meganesu) Megan Sullivan Website (https://meganesulli.com/) Apollo (https://www.apollographql.com/) DEV Community (https://dev.to/) The Social Network (https://www.imdb.com/title/tt1285016/) Steph Smith Website (https://stephsmith.io/) Personal User Manual-Megan Sullivan (https://meganesulli.com/manual/) Being Glue-Tanya Reilly (https://noidea.dog/glue) GatsbyCamp Fall-Docs for Everyone-Megan Sullivan (YouTube) (https://www.youtube.com/watch?v=HnBNbG2Csv8) The Secret History of Women in Coding (The New York Times Magazine) (https://www.nytimes.com/2019/02/13/magazine/women-coding-computer-programming.html) Docs for Developers: An Engineer’s Field Guide to Technical Writing (https://www.amazon.com/Docs-Developers-Engineers-Technical-Writing/dp/1484272161/ref=sr_1_1?crid=1LTLCGI1CMX4U&keywords=Docs+for+Developers&qid=1645316465&sprefix=docs+for+developers%2Caps%2C71&sr=8-1) Write the Docs Portland 2022 (https://www.writethedocs.org/conf/portland/2022/cfp/) DevEdBookClub Twitter (https://twitter.com/devedbookclub) 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: Megan Sullivan.

Summary


Sponsored by
Document Write · EthicalAds · Sourcegraph

Panelists

Portia Burton | Eric Holscher

Guest

Megan Sullivan

Show Notes

Hello and welcome to Let’s Talk Docs! This is our first episode and we’re so happy you’re joining us. On this podcast, we’ll be sharing with you a new concept around documentation and sustainability. We’re going to talk about how you can leverage documentation, how you can leverage content to bring more people, more attention, and more funding to your products. We’ll talk to experts who know how to write content engagingly, interview people who speak about the importance of content having goals, and talk to people who have successfully built projects, used excellent documentation, and used the content as the pillar of their success. Our panelists are Portia Burton, who is the owner of DocumentWrite, and Eric Holscher, who is the Co-Founder of Read the Docs, Write the Docs, EthicalAds, and PyCascades. We are super excited to have as our guest, Megan Sullivan, who is a Developer Educator at Apollo. Megan shares her background and story about studying CS, going into teaching CS courses, and how putting the two together helped her become a more confident professional developer and create a path for others with an educational background. We find out about a manual Megan wrote about herself, what “Being Glue” means, and she shares advice if you’re the person who’s interested in taking this journey similar to what she’s doing in technical writing and education. Go ahead and download this episode now!

[00:01:27] We hear what Megan did before specializing in technical documentation.

[00:06:16] Megan mentioned teaching people to code when she did the AmeriCorps program, and Portia wonders if she were to go back and design a CS program how would she do it that would be engaging.

[00:10:44] Megan shares what inspired her to get into technical writing.

[00:14:51] On Megan’s website, she has a page dedicated to accessibility, and she tells us about the manual she wrote about herself and she mentions Steph Smith’s website.

[00:16:51] Find out what inspired Megan to publish her manual and share it.

[00:18:28] Portia talks about notetaking and “Being Glue,” and asks Megan’s opinion on what she would say about women who want to help out their team but don’t want to be like glue.

[00:23:20] We hear Megan’s thoughts on ways she thinks documentation can be taken more seriously, and how can we get people in college to get excited and build that status in the industry to get people excited.

[00:27:44] Megan shares some advice if you’re interested in following this kind of path of teaching technical stuff, and she tells us about a great book, Docs for Developers.

[00:32:25] We end with some shout-outs and cool things happening that you should check out.

Quotes

[00:07:40] “There are a lot of different ways that knowing how to code can help you in different industries.”

[00:09:02] “Right when I started that program was around the time the movie The Social Network came out, and I thought if this is what being in tech is like I want no part in that.”

[00:14:21] “I like trying to figure out how to make things look pretty and I’m not good at it, but I like thinking about that and thinking about accessibility is something I’m really interested in.”

[00:23:42] “I think a good way to get people to take documentation seriously is to talk about what’s hard about documentation.”

Links

SustainOSS

SustainOSS Twitter

SustainOSS Discourse

Portia Burton Twitter

Eric Holscher Twitter

DocumentWrite

Write the Docs

Read the Docs

EthicalAds

PyCascades

Megan Sullivan Twitter

Megan Sullivan LinkedIn

Megan Sullivan Website

Apollo

DEV Community

The Social Network

Steph Smith Website

Personal User Manual-Megan Sullivan

Being Glue-Tanya Reilly

GatsbyCamp Fall-Docs for Everyone-Megan Sullivan (YouTube)

The Secret History of Women in Coding (The New York Times Magazine)

Docs for Developers: An Engineer’s Field Guide to Technical Writing

Write the Docs Portland 2022

DevEdBookClub Twitter

Credits

Special Guest: Megan Sullivan.

Sponsored By:

Subtitle
Megan Sullivan is a Developer Educator at Apollo. Megan shares her background and story about studying CS, going into teaching CS courses, and how putting the two together helped her become a more confident professional developer and create a path for
Duration
35:09
Publishing date
2022-02-22 21:00
Link
https://ltd-podcast.sustainoss.org/1
Contributors
  SustainOSS
author  
Enclosures
https://chrt.fm/track/28DGC9/aphid.fireside.fm/d/1437767933/98ecf3aa-9157-4278-a770-0bae0b9b7d99/f2791b03-4157-4f9a-8c1b-f3f132e47d96.mp3
audio/mpeg

Shownotes


Sponsored by
Document Write · EthicalAds · Sourcegraph

Panelists

Portia Burton | Eric Holscher

Guest

Megan Sullivan

Show Notes

Hello and welcome to Let’s Talk Docs! This is our first episode and we’re so happy you’re joining us. On this podcast, we’ll be sharing with you a new concept around documentation and sustainability. We’re going to talk about how you can leverage documentation, how you can leverage content to bring more people, more attention, and more funding to your products. We’ll talk to experts who know how to write content engagingly, interview people who speak about the importance of content having goals, and talk to people who have successfully built projects, used excellent documentation, and used the content as the pillar of their success. Our panelists are Portia Burton, who is the owner of DocumentWrite, and Eric Holscher, who is the Co-Founder of Read the Docs, Write the Docs, EthicalAds, and PyCascades. We are super excited to have as our guest, Megan Sullivan, who is a Developer Educator at Apollo. Megan shares her background and story about studying CS, going into teaching CS courses, and how putting the two together helped her become a more confident professional developer and create a path for others with an educational background. We find out about a manual Megan wrote about herself, what “Being Glue” means, and she shares advice if you’re the person who’s interested in taking this journey similar to what she’s doing in technical writing and education. Go ahead and download this episode now!

[00:01:27] We hear what Megan did before specializing in technical documentation.

[00:06:16] Megan mentioned teaching people to code when she did the AmeriCorps program, and Portia wonders if she were to go back and design a CS program how would she do it that would be engaging.

[00:10:44] Megan shares what inspired her to get into technical writing.

[00:14:51] On Megan’s website, she has a page dedicated to accessibility, and she tells us about the manual she wrote about herself and she mentions Steph Smith’s website.

[00:16:51] Find out what inspired Megan to publish her manual and share it.

[00:18:28] Portia talks about notetaking and “Being Glue,” and asks Megan’s opinion on what she would say about women who want to help out their team but don’t want to be like glue.

[00:23:20] We hear Megan’s thoughts on ways she thinks documentation can be taken more seriously, and how can we get people in college to get excited and build that status in the industry to get people excited.

[00:27:44] Megan shares some advice if you’re interested in following this kind of path of teaching technical stuff, and she tells us about a great book, Docs for Developers.

[00:32:25] We end with some shout-outs and cool things happening that you should check out.

Quotes

[00:07:40] “There are a lot of different ways that knowing how to code can help you in different industries.”

[00:09:02] “Right when I started that program was around the time the movie The Social Network came out, and I thought if this is what being in tech is like I want no part in that.”

[00:14:21] “I like trying to figure out how to make things look pretty and I’m not good at it, but I like thinking about that and thinking about accessibility is something I’m really interested in.”

[00:23:42] “I think a good way to get people to take documentation seriously is to talk about what’s hard about documentation.”

Links

SustainOSS

SustainOSS Twitter

SustainOSS Discourse

Portia Burton Twitter

Eric Holscher Twitter

DocumentWrite

Write the Docs

Read the Docs

EthicalAds

PyCascades

Megan Sullivan Twitter

Megan Sullivan LinkedIn

Megan Sullivan Website

Apollo

DEV Community

The Social Network

Steph Smith Website

Personal User Manual-Megan Sullivan

Being Glue-Tanya Reilly

GatsbyCamp Fall-Docs for Everyone-Megan Sullivan (YouTube)

The Secret History of Women in Coding (The New York Times Magazine)

Docs for Developers: An Engineer’s Field Guide to Technical Writing

Write the Docs Portland 2022

DevEdBookClub Twitter

Credits

Special Guest: Megan Sullivan.

Sponsored By: