technical – Jupiter Broadcasting https://www.jupiterbroadcasting.com Open Source Entertainment, on Demand. Wed, 09 Sep 2015 11:40:09 +0000 en-US hourly 1 https://wordpress.org/?v=5.5.3 https://original.jupiterbroadcasting.net/wp-content/uploads/2019/04/cropped-favicon-32x32.png technical – Jupiter Broadcasting https://www.jupiterbroadcasting.com 32 32 No Crying In Coding | WTR 39 https://original.jupiterbroadcasting.net/87421/no-crying-in-coding-wtr-39/ Wed, 09 Sep 2015 03:40:09 +0000 https://original.jupiterbroadcasting.net/?p=87421 Carolyn went from working in data science to mobile developer at Lookout Mobile. She discusses writing “magic hands” to automate her old job & what it’s like to self teach. Direct Download: MP3 Audio | OGG Audio | Video | HD Video | YouTube RSS Feeds: MP3 Feed | OGG Feed | iTunes Feed | […]

The post No Crying In Coding | WTR 39 first appeared on Jupiter Broadcasting.

]]>

post thumbnail

Carolyn went from working in data science to mobile developer at Lookout Mobile. She discusses writing “magic hands” to automate her old job & what it’s like to self teach.

Direct Download:

MP3 Audio | OGG Audio | Video | HD Video | YouTube

RSS Feeds:

MP3 Feed | OGG Feed | iTunes Feed | Video Feed

Become a supporter on Patreon:

Foo

Show Notes:

Transcription:

ANGELA: This is Women’s Tech Radio.
PAIGE: A show on the Jupiter Broadcasting Network, interviewing interesting women in technology. Exploring their roles and how they’re successful in technology careers. I’m Paige.
ANGELA: And I’m Angela.
PAIGE: So, Angela, today we talk to Carolyn and she is a recent mobile developer at Lookout. She comes from a data scientist background and we have some really interesting chat about her transition and just all the things that she’s gotten into; what’s been hard, what’s been awesome, and it’s a really good time.
ANGELA: Yeah. And before we get into the interview I just want to mention that you can support Women’s Tech Radio by going to Patreon.com/today. It is a subscription based support of our network. It supports all the shows, but specifically this show, Women’s Tech Radio. So go to Patreon.com/today.
PAIGE: And we got started by asking Carolyn what she’s up to in technology these days.
CAROLYN: Yeah, so I have sort of an interesting story of, or at least I think it’s interesting, of how I got into tech. I was a business major, not sure what I wanted to do with my life. Ended up in operations at a big company, but I always really, really loved data and I just loved spreadsheets and i met someone that let me, sort of taught me SQL and taught me how to be faster with what I was doing with SQL and I found out I really loved SQL. So I sort of just started building from there. I ended up at Lookout which is a mobile security anti malware company and just sort of opened my eyes to a lot of technology. I started as a data analyst. Started managing the data warehouse and then earlier this year just moved over to Android development. So I’m learning a lot. So I’m new to engineering, but I have been speaking engineer, that’s what I say, for a very long time. So right now I”m working on a side project which we’ll be releasing at the end of this year and currently learning RxJava, which is pretty new. It’s really cool, but there’s definitely not really a lot out there about it. So I spend my days currently just really doing a lot of learning.
PAIGE: All right. So I will admit, I am not familiar with RxJava. How is it different than normal Java?
CAROLYN: It deals with like streaming data and so it’s really good for when you’re trying to chain things together without, you know, the data might not be available yet.
PAIGE: Oh, okay. So it’s Java non-blocking?
CAROLYN: Yeah.
PAIGE: Cool. You can probably continue explaining that for the audience.
ANGELA: And me.
PAIGE: Oh yeah.
CAROLYN: Well I’m still wrapping, I was just, like, so I, earlier this year did an online Android boot camp while I was still doing my data job and managing the data team and just sort of doing 20 things at once. And now, once I started to feel like I really got a foothold in Java, we decided to use RxJava and now I’m relearning a lot of things. So it’s still, I’m still feeling like I’m in a foreign country where I don’t speak the language. So I’m definitely, it’s made me actually have this huge respect for Netflix, because they are the ones that wrote the Android library for it and they’re just doing so much cool stuff over there. And they have a lot of good tutorials about it. So I definitely recommend, there’s a podcast about it and the head at Netflix is talking about RxJava. It’s really interesting. So I can add that to the show links for you guys too.
PAIGE: Netflix is really interesting because they, essentially their stack, they’re really stack agnostic where they look at their teams and they say do what you need to do to get your job done. And find the best way to do it. So I know that they have angular, amber, you know, they have imbedded team. The have the RxJava team and they all just kind of talk together because they really piece these pieces out. It’s really fascinating how they’re kind of making that work with being probably one of the biggest data companies in the world right now.
CAROLYN: Yeah. Well they’re definitely finding, you know, if there’s not a tool out there that meets their needs, they’ll build it. I have a friend who’s a doctor and I was explaining this concept to her and she was like this is so weird. She was like, why would they build it and open source it? You know. For me, personally, one of the things I actually stumbled upon in the tech community, which I didn’t really realize, is just the amount of support that people are willing, and companies are willing to give each other. I mean, there’s obviously companies that are competing and hate each other, but at the same time, I’m sure if you got their engineers together they would talk shop and share things they’re doing and it’s really cool. When I decided to be an engineer, late last year, I had so many people that were giving me free materials and helping me and the tech community, like every night of the week you can go to a meetup and have dinner and meet people and have people help you. Which was sort of a happy accident to find out about the tech community in general.
PAIGE: Yeah. I totally love that. And I love that it comes out of some of our roots of open source and being able to reach out and touch each other’s projects and just help out. I was listening to a podcast recently, ironically, and they were talking about how they’d opened sourced their website, kind of, It’s a paid service. The guy was like, I”m shocked because every week we get somebody who just pops in and was like hey I forked your website and made this change, because I found this problem and here it is back. And this guy that fix things is a paid customer of theirs, but he’s still jumping in to fix things for the company. It’s just like-
CAROLYN: Yeah.
PAIGE: Really awesome.
CAROLYN: Yeah. Actually, the boot camp that I did, um, is Code Path, which is a link in the show notes. And what they do is they go out to companies and do consulting and then they also have a boot camp if you are an engineer that you can, if you’re already two or three years in you can go. So I wasn’t like a candidate to be part of their boot camp. And even part of the consulting, my company said they’d pay for it, but they said you really need to learn Java before you do this boot camp. So they gave me all the materials for free. And they just said I could learn it on my own, which was pretty awesome. And had calls with me and sort of got me started on my path, just totally pro bono, which is really awesome.
ANGELA: That is really awesome.
CAROLYN: Yeah.
PAIGE: Very cool. Okay. So as a developer, I have to ask, how is it that it was SQL that grabbed your attention, because most developers I know just absolutely hate working in SQL, like we will avoid it like the plague. I actually kind of got my start in SQL as well, so I do like it, but most people I talk to they’re like I love all this web stuff, please don’t make me write SQL.
CAROLYN: Yeah, so what’s funny is the engineers on my team, when I see the SQL queries are writing I’m like, I’m so happy because that’s a place I can teach them and be like whoa this is not good. So what happened was, I was working for Williams Sonoma, which is, they also own Pottery Barn and they run it as this big monolithic company where they don’t really care if people are efficient and they would be perfectly happy with people just entering data all day instead of making efficient processes or systems. It was my first job out of college so I didn’t really know that life didn’t really have to be like that. So I was spending a lot of time manually going in and doing things and I just so happened to meet someone in my company named Mark Grassgob [ph] who really opened the door for me. He’s like just learn SQL and you can do this job that took you all day, you can do it in like 20 minutes. So it was more just a fact of me being like this is pretty powerful. These people are really living in the dark ages. So we literally wrote a script that would do our jobs for you. We called it magic hands. And then we’d go to coffee and no one that i worked for really — they just wanted us to get the work done. They didn’t know that we could eliminate everyone’s jobs and we’re like — we called it magic hands. It was so funny. We’d unleash magic hands on three computers and then realize oh the system couldn’t take that much input so we’d bring it down to two. And then it would enter in a price of a million dollars for a couch instead of $1,000 or something and so we’d get a call from like, you know, tech team in India overnight when something process blew up, so we definitely had to fine tune magic hands. Then I moved over to the technical team after that, because they sort of saw she can actually be on this team and do this without having really a background. And then once I moved into data, it’s like SQL is king no matter what anyone says about big data and all these big data tools. It really, the backbone of everything is really SQL. So learning how to do efficient queries will make your job so much happier. If you write SQL wrong you’re going to give people wrong answers. So on the data side, you know, SQL just, to me, just made so much sense. But I guess it was sort of the first real programming I ever got my hands on. I love it.
PAIGE: I actually have had a couple friends recently who have asked me, because I kind of learned SQL the hard way by just throwing my head against Access, which is probably the worst interface ever.
CAROLYN: Yeah.
PAIGE: But do you have any good recommendations for books for online resources for SQL, because it’s kind of like this weird black hole where i can learn almost everything else online and I can’t seem to find anything good for SQL.
CAROLYN: The thing about SQL is that you will not be good at it. You will not really get your hands around it until you actually use it. So it’s one of those things where you need access to a dataset and you need questions to answer and then you’ll get it. So there are resources out there. I actually, when I was hiring data analyst as a manager I just created my own dataset and posted it for people and then had them answer some questions to show me they knew SQL or not. It’s really a learning by doing kind of thing. Which I guess most things are. But if you don’t have an interesting dataset to work with and you’re not trying to solve interesting problems, you’re just never going to pick it up. But I haven’t really found, there are available datasets out there and as bad as Access is and it gives you the graphical interface, don’t use that, you need to actually physically write it out. If you use Access, if you get access to a dataset dump it into Access and then use the, just handwriting the SQL, you know, you’ll get it.
PAIGE: Yeah, totally.
ANGELA: So in the form that you filled out before the show you said that you’re still trying to figure out why you never thought to be an engineer before.
CAROLYN: Yeah.
ANGELA: I think there’s a lot of people that don’t know that the way their personality and skills would make them perfect for a position. What would you recommend people do to figure out what best to be or do or try?
CAROLYN: I’ve been thinking about his a lot, actually. When I was younger, I grew up in San Diego and it was very much a beach culture, like very dude broey. It wasn’t cool to be smart when I was a kid. That’s how I felt. I was networking the internet in my parent’s house, like running the wireless, created their wireless, and I was one of the first people on Napster stealing music and creating CDs. I had this little computer in my room and my friends would come over and they’d be in their bikinis like beep, beep, let’s go to the beach. Did you make us CDs? I’m just like, you know, like stealing music off the internet. But to me, it was like, I mean this is like 1998 so I was really probably one of 10,000 people doing this.
PAIGE: We might have shared that stolen music together.
ANGELA: Yeah, I was just going to say, yeah 1998, that was golden year too for Napster and WinAmp.
CAROLYN: Yeah, totally.
PAIGE: It’s really kicks the llama’s ass.
ANGELA: Yeah.
CAROLYN: But for some reason it never crossed my mind that I was really good at this. I was way more interested in it than any of my friends. But instead I just was like, I’m just going to go to the beach and we’re going to try to get beer and do all these things. And I’m trying to figure out why it never crossed my mind to do that. But I also think it was a different time and technology wasn’t, people weren’t talking about technology. People weren’t interested in talking about apps. You know, like 1 in 20 people had a cell phone back then.
ANGELA: Right.
CAROLYN: So I think maybe it was just kind of like that time. When I went to college I was a business major and I thought I would just do business. I wasn’t really sure what I wanted to do. I think I had all the tools and I knew that i loved computers and I loved building things, but I never really had someone set me down. I never really had that career thought. I just sort of followed the path that I thought was laid out. And it really wasn’t until like mid last year that I thought I could really be an engineer and do it. It was really — what sort of tipped me was all these boot camps coming out and people just going and doing it. I had this deep — this thought of what would I do if I could do anything and I wasn’t scared to do it? To me, engineering was it. Lookout was incredibly supportive and let me move teams, which was really great and sort of a rare find in a company that would support someone to do this. So I got really lucky. But, you know, I think now with Women Who Code and a lot of organizations asking these questions of why women aren’t engineers, I think it’s because no one ever asked me and I never asked myself. And now that it’s sort of becoming the norm, you know, I’m hoping that more women will sort of naturally follow the path to be an engineer, because I think if there would have been more of that growing up that I probably would have found that path earlier.
PAIGE: That’s actually a part of why we started the podcast is because, you know, you say oh it was a different time then. And it was actually my conversation with a 16 year old that spawned me to start this, because I had this conversation and the 16 year old is good at math, enjoyed science, liked tech stuff, you know, didn’t do the assembling computers thing because nobody really do that anymore. But I was like, well have you considered being a programer? And she was like, no that’s for boys, right? And I was like, whoa.
ANGELA: Yeah.
PAIGE: And this was last year.
CAROLYN: Yeah.
PAIGE: But I do think it’s changing. I think organizations like Women Who Code Girl Develop It, Chick Tech, all these different things are kind of getting in there and saying hey guys, or hey ladies you can do this too. And there’s no reason, like — like I like to say, girls type just as well as boys.
ANGELA: So I haven’t been to a boot camp, but it seems like that might be, aside from trying to join Women Who Code or another place like that that would support you, but the boot camp might help you. Is it like a conference where you can go and listen or watch different parts of development?
CAROLYN: I did a lot of research on boot camps at the end of last year and there’s some good and — there’s a lot of good, but there’s also a lot of bad. You can’t expect to just go somewhere for three months and then come out and be a fully fledged engineer and be ready to work, you know. So this boot camp is just a once a week for two hours for eight weeks kind of thing. Or I think it’s twice a week for two hours for eight weeks. But they are teaching mobile development to people who are already engineers. They just gave me — they record their lectures and they have all their assignments online and they just gave me access to their materials so I could write — I could work on apps on my own. I’d say it definitely took me a lot longer to get through it and I ended up just doing the parts of the boot camp that really applied to what I”de be working on at Lookout so I could just get up to speed faster, but, you know, their boot camp, there would be like a week of work would take me three weeks or something just to get done. Definitely was like, it took me a while to get through it. But it really is, I couldn’t say enough good things about Code Path. They do some really cool stuff. And they’re really smart guys. Actually, all men, but they do have a lot of women that go to their boot camps, so.
PAIGE: There’s definitely a really wide range of what we’re calling a boot camp right now. We have Codepath which is this kind of part-time thing. ANd there will be other online part-time things. And then there’s even in-person part-time things where you can go in the evenings and it’s a full five days a week. The boot camp that I worked out of is full five days a week. It’s a 16 week program if you do it at night or a 12 week program if you do it in the day. And it is full stack development. You go from the front end all the way through the back end. And I think that’s probably the most common is that it’s essentially two to three months. Some of them go out as far as six months of get in there, get your hands in code, have a portfolio at the end kind of a thing. But agree with you, Carolyn, that you can’t go into a boot camp expecting to come out the other end like a full fledged developer unless you work your butt off. And there are companies hiring beginners. I think that the market is getting a little bit saturated, because there are so many boot camps.
CAROLYN: Yeah.
PAIGE: I’m in Portland, it’s a fairly small city, and I think right now we have five boot camps.
ANGELA: Wow.
PAIGE: And one of them is turning out two classes of 60 people each every 10 weeks.
ANGELA: Wow.
PAIGE: So it’s getting a bit saturated, but the market is still there.
CAROLYN: Yeah, and so I have friends in San Francisco that are recruiters and when I was switching over they were like whoa, whoa, whoa, don’t do boot camp. Don’t do it. We can’t hire people out of boot camps. There’s like 1 out of 20 that are hireable, you know. And so I was like, okay. And I had some talks with them and they were like, you have to — if you’re going to do a boot camp you also have to have another strategy of how you’re still going to become and engineer, you know. You do the boot camp but where are you going to — who is going to take you on as a junior developer? You need to have all those things sort of lined up.
ANGELA: Right.
CAROLYN: Or else you’re just going to do the boot camp and then go do something else.
PAIGE: Yeah. And I think that there are some things coming into the market that are trying to fill that. There’s a couple places like Thoughtbot has apprenticeship programs. A couple of the other bigger dev shops have that where you can kind of transition from beginner into intermediate. And then there’s some online stuff like Think Full or Upcase where you can kind of build those skills after boot camp. And, of course, I’m always a fan; I think the biggest thing in our industry and most industries is mentorship. Like finding a mentor. Finding those people and going out and shaking hands.
ANGELA: Which you’d likely find at Women Who Code or Meetups or-
PAIGE: Totally.
ANGELA: The social aspect of it.
PAIGE: Meatspace as we like to call it.
CAROLYN: Yeah.
PAIGE: For nerd speak.
ANGELA: Whenever I hear meetspace I picture M-E-A-T.
PAIGE: That’s what it means.
ANGELA: Oh. Not M-E-E-T?
PAIGE: No. It’s it’s M-E-A-T.
ANGELA: Oh.
PAIGE: Meatspace.
ANGELA: Why?
PAIGE: Because we’re nerds and it’s not digital, so it’s fleshy, so it’s meat.
ANGELA: Oh my gosh. Okay. Interesting. Okay.
PAIGE: Sorry.
ANGELA: Wow, that’s a great, I’m glad, okay. Continue with the interview.
PAIGE: Yeah. So you talked a little bit. You’ve moved over to the Android team. What’s fun and what’s hard about Android? I haven’t really dug in on Android development. I’ve done some iOS.
CAROLYN: What’s really fun about Android is, you know, day one you can open up your Android Studio and download the STK and create a page. It has like a button, you know, and you can click the button and it can like play a song. You can do that in two days. You can publish it to the app store. You could put it on your phone. There’s definitely this — you can hit and API and pull data back. You know, you could do that in a couple days, learn all that from scratch. So there’s a very easy sort of, like, you know, there’s a link on Learning to Code in the notes where it’s a graph of — at first you, like, peek. It’s like a honeymoon at first. ANd everything seems really easy, but as you sort of start to unfold things, Android is really complicated and there’s 9,000 versions of Android that people are running out there and different sized devices and tablets and people are going to be using your app only on Wifi, and there’s so many things to think about. As you want to do more, you get royally confused very quickly. So it’s cool to just sort of get up and running and get started, but there’s a lot to learn. There’s things you have to think about like battery usage and memory and all these things that you don’t really deal with if you’re a web developer. So it’s definitely a lot to get started. I work on a team where there’s a lot of senior engineers and a lot of people that really know what’s going on, so it’s like, it’s fun but it’s also — you know, you take some hits to your ego a little bit, because I feel like I used to know everything about the data warehouse and stepping into something where you don’t know what’s going on and you really have to feel your way through it, it can be a shot to your ego and how you feel about yourself. I always say, like, sometimes i feel like Tom Hanks, like when I get code reviews, like in a League of Their Own where he’s like, “There’s no crying in baseball.”
PAIGE: Uh-huh.
CAROLYN: Like, I literally have to tell myself, there’s no crying in coding when I get a lot of comments on a code review or I just totally, like — it’s a lot of falling down. A lot.
PAIGE: I’m so glad I’m not the only person that says, there’s no crying in coding.
CAROLYN: Yes, I say that to myself all the time.
PAIGE: Me too.
CAROLYN: It makes me feel better, because at least I’m out there. I’m out there and I”m like, they’re always like, oh no you’re doing really, really good, you just have this — where you just want — I want to be — I don’t want to say, I want to be perfect, but I want to be contributing and I don’t — I want to be getting things done and moving forward and writing really good code and you’re not going to do that when you move into engineering for like a year or two, you know. So just setting those expectations. You just have to lower your expectations for yourself a little bit.
PAIGE: Yeah. I think — this is a talk that I have with a lot of — I meet a lot of junior developers through Women Who Code and explaining to them, like listen I”ve been doing coding for a lot of years as a professional now, and there’s rarely a week that goes by where I don’t go, wow I feel like I know nothing.
CAROLYN: Yeah.
PAIGE: I”m totally Jon Snow. It’s not fun.
CAROLYN: But then when I share that feeling with other developers they’re like, welcome to being an engineer.
PAIGE: Yep, exactly.
CAROLYN: That’s what everyone says to me. They’re like oh you were frustrated all day and the last 10 minutes of your day everything made sense and you got it to run, like that’s your life.
PAIGE: Uh-huh.
CAROLYN: And I kind of love that. Like, personally. I actually really love that. I love working all day on a problem . To me, the day goes by in 30 minutes to me, even if I want to cry sometimes. It’s fun and I feel like I’m using more of my brain than I ever did before.
PAIGE: Yeah, it’s like 30 minutes of success after an entire day of the crying game.
CAROLYN: Yeah.
PAIGE: It’s totally, it’s where you’re at. And I think that knowing that going in, I like to say that programmers need to be eternally optimistic because it will work this time, I swear.
ANGELA: Thank you for listening to this episode of Women’s Tech Radio. Remember you can find a full transcription of this show over in the show notes at JupiterBroadcasting.com. YOu can also subscribe to the RSS feeds.
PAIGE: And while you’re there you could also reach out to us on the contact form. Let us know what you think about the show or any guests you might like to hear. Don’t forget, we’re also on iTunes and if you have a moment leave a review so we know how we’re doing and how we can improve the show. If you’d like to reach out to Angela and I directly, you can use WTR@JupiterBroadcasting.com for an email or check us at at Twitter, @HeyWTR. Thanks for listening.

Transcribed by Carrie Cotter | Transcription@cotterville.net

The post No Crying In Coding | WTR 39 first appeared on Jupiter Broadcasting.

]]>
Technical Writing | WTR 37 https://original.jupiterbroadcasting.net/85727/technical-writing-wtr-37/ Wed, 29 Jul 2015 10:45:13 +0000 https://original.jupiterbroadcasting.net/?p=85727 Jami is a technical writer for Agency Port Software, a web based software for P&C insurance. Direct Download: MP3 Audio | OGG Audio | Video | HD Video | YouTube RSS Feeds: MP3 Feed | OGG Feed | iTunes Feed | Video Feed Become a supporter on Patreon: Show Notes: Learn to Code by Doing […]

The post Technical Writing | WTR 37 first appeared on Jupiter Broadcasting.

]]>

post thumbnail

Jami is a technical writer for Agency Port Software, a web based software for P&C insurance.

Direct Download:

MP3 Audio | OGG Audio | Video | HD Video | YouTube

RSS Feeds:

MP3 Feed | OGG Feed | iTunes Feed | Video Feed

Become a supporter on Patreon:

Foo

Show Notes:

Transcription:

ANGELA: This is Women’s Tech Radio.
PAIGE: A show on the Jupiter Broadcasting Network, interviewing interesting women in technology. Exploring their roles and how they’re successful in technology careers. I’m Paige.
ANGELA: And I’m Angela.
PAIGE: So Angela, today we’re joined by Jami. She’s a technical writer with a company in Boston. She does a lot of interesting work trying to translate developers and in her position for developers. So we talk a little bit about that and we get into what it means to be a technical write and kind of dig into that whole career path.
ANGELA: And before we get into this interview, I would just like to say that you can support the network and the ongoingness of this show, Women’s Tech Radio, by going to pateron.com/today. And that is where you will find that we put out a podcast specifically to thank the patrons that are supporting the network. It’s Tech Talk Today. It’s a quick show that we do four days a week of the top headlines. And it’s just a thank you. It’s something that we’re able to launch because we are getting funding that way. So, again, you can support Women’s Tech Radio through patreon.com/jupitersignal.
PAIGE: And to get started, we asked Jami what she’s doing in technology today.
JAMI: I’m currently a tech writer. I work for Agency Port Software in Boston. We are a technology company that offers web-based software and tools to P&C insurance companies, and I’m pretty much responsible for creating and maintaining all of their product documentation and as well as the developer documentation site where all that documentation lives. So mostly my responsibilities are related to actual documentation. So I document any updates to the products and the release notes whenever releases go out. And then the other half is I’m actually dealing with the technical aspects of the site. So we make sure everything is up and running, everything is displaying properly, the styles look good, the features looks good. I”m working mostly in a tool called MadCap Flare. It’s an authoring tool. But I also work heavily in CSS and a little bit of Javascript and now learning a little bit more about Bootstrap.
PAIGE: So are you working in MadCap Flare? Is that like your internal program and then you’re also starting to author some of the stuff for the web and that’s why you’re diving into CSS and HTML and stuff?
JAMI: Yeah. So, MadCap Flare, it’s an external software component that you can use to actually build documentation sites. So you kind of organize everything and it builds HTML files that then compile out that you can build an actual site with. But we wanted something a little bit more modern and that we can customize a lot more than what’s built into the product. So that’s why we kind of bring in the CSS and the Javascript and the Bootstrap so that we can make it a little bit more modern and trendy to kind of meet our company’s branding.
PAIGE: So is this something — technical writing is actually — we haven’t had a technical writer on the show yet.
ANGELA: Uh-uh.
PAIGE: So this is kind of fun. What does it mean to do technical writing? I think you kind of grazed over it, but what do you do as a technical writer, like in the nitty gritty?
JAMI: Well, in my position now you’re working with the developers. You’re working with the engineers to find out exactly what is done on a project as related to a product. So whenever they make changes, we have to make sure that we’re relaying that information to whoever the audience is. So in my current case, our audience is actual developers who are customizing our software for clients. So they need to learn how to customize everything. So those updates go in for the content and we also relay the updates as for release notes. So we’re constantly keeping communication to our clients to what we’re being, what’s being done into the product.
PAIGE: So you’re kind of translating developers, and in your position, for developers?
JAMI: Yes. In prior positions where I’ve worked as a tech writer it was kind of the opposite. Where I was interpreting developers notes and trying to decipher it into a language that any man could understand, like they have no technical background but they need to understand. But in my current case it’s, I’m actually relaying developer information for another developer, if that makes sense.
ANGELA: Yeah.
PAIGE: Totally. So are you super technical? Are you a developer yourself? How does that work for you to kind of translate like that?
JAMI: I’m not really a developer per say. I mean, I’m starting to learn a lot more, especially in the past year or so. But I’m more of the content side of it. So I can understand it, but if you give me something to code completely in Javascript, i don’t know how to do that just yet, but I could at least read it and understand what’s going on.
PAIGE: Well, that’s actually a lot farther than some developers I know. So you’re doing really well.
JAMI: Thanks.
PAIGE: Is that something you went to school for? To be — either to understand Javascript or to be a technical writer?
JAMI: Actually, no. I actually don’t have really any formal training as far as even technical writing. My degree was actually in creative writing and journalism and I started working for a small IT company right out of college kind of helping with their help desk and I just gradually made my way up. And now today, I — since working with developers and having to actually look at code, it’s kind of forced me to learn, but also — I’m mean it’s not like a forcing, but — so it’s interesting to finally learn how to do some of this stuff. And then actually to learn more. I’ve been taking classes on Code School and Codecademy and trying to actually dig into code and try to figure it out so that I can understand what they’re talking about.
PAIGE: Very cool. So you’re self-teaching yourself so you can have more understanding at work?
JAMI: Right. Exactly.
PAIGE: And do cool things. Very cool.
JAMI: Right.
PAIGE: That’s actually how I got started.
JAMI: Very nice.
PAIGE: I always like to ask this sort of question, but how does it flip around? Do you feel like you have this creative writing and journalism background and you’re trying to learn code. Do you feel like any of the developers are actually trying to learn how to write more like humans?
JAMI: In some cases, yes. Yes.
PAIGE: Awesome.
JAMI: Or maybe we wish that they did, I guess.
PAIGE: Maybe somebody should write a Codecademy for technical writing so that we could learn how to write better documentation.
JAMI: That would be nice.
PAIGE: Yeah. I think they’re based out of Boston or New York. I think they’re in New York.
JAMI: I’m not sure. Yeah.
PAIGE: They’re very close. How did you get where you are? It sounds like you started out of college and you had the college degree. Have you always had an interest in tech or was it just kind of that random happenstance?
JAMI: Well, I mean, I’ve always been into computers and tech, and I’m really tech savvy. So just kind of, I kind of fit in right away in the department and I just — I love it. I mean, I’m always learning something new. It’s always evolving. So, I just — I’ve kind of found that happy medium where I’m writing, but I’m also getting the chance to actually work in tech.
PAIGE: I think it’s interesting how the tech — like if we look at it from a broad perspective. It really is a very deep field. It takes a lot of disciplines. You know, we’ve had so many different people on the show; artist, developers, designers, and writers now and there’s really — there’s room for all of us in this field to do good things.
JAMI: Right.
PAIGE: So why tech? You said you’re tech savvy. What does that mean to you and is it — what kind of stokes your fire in the tech end of things?
JAMI: Well, I think it’s kind of — because I have this personality where I like to kind of be a detective and try to figure things out. So I think in tech I kind of get that opportunity. Where it’s like, oh I don’t know why this page isn’t showing up right. Let me see why. Let me try to fix this. Okay, that’s not working. Let me try this. And just trying to find the answer. If it’s either online or talking to people. And it’s like you kind of get the opportunity to see what you did right away.
PAIGE: Yeah. We actually had an interview, a couple of weeks ago by now, where we talked to somebody about failing. And I think that willingness to explore and to fail forward, like oh does this worK? And to break it and then fix it is — that’s that mindset for me. It’s super important.
JAMI: Absolutely. Yeah, and it helps you learn because I mean for me I’m more of a hands on person, so actually digging in and trying to do things is how I’m going to figure out how to do it.
ANGELA: Is there anything tech related that you do outside of work, like hobby wise? Like blogging or?
JAMI: I did for a while. I was — I did blog for a while. I did some side freelance work for Bot.com for a while, for like two years. So I had to maintain their — maintain my — I had my own personal site and I had to do all that stuff. I was into photography for a while. So I was editing photos a lot. Right now I just really — I honestly haven’t had a whole lot of spare time to do a lot of outside tech related stuff, but I mean I’ve been using a computer for the past probably 20 years or so.
ANGELA: Yeah.
J; So it’s like attached to me. It’s just a part of our lives now. Tech is always around me.
PAIGE: Yeah, totally. You can’t get away from it anymore.
JAMI: No. It’s like a — it’s literally attached to you hip.
PAIGE: I guess you could move to Amish country in Pennsylvania.
JAMI: Yeah.
PAIGE: That’s about it.
ANGELA: I heard there’s a really good buffet.
PAIGE: Really?
ANGELA: Yeah, really.
PAIGE: I don’t know. I mean, are they offended-
ANGELA: My mom went to it and so did one of my friends.
PAIGE: I’ve had some of the best pancakes ever in Amish country, so maybe it’s relevant. I don’t know. Very fun. So you’re in the Boston community. How is the — kind of the tech community out there?
JAMI: It’s really booming right now, it seems. I mean, I’ve been here a little over a year, but especially in the area we’re in, we’re kind of near South Boston and just companies are moving in, startups and just everything. It’s very tech heavy right now.
PAIGE: I’m from the Boston area, I will admit.
JAMI: Uh-huh.
PAIGE: What is kind of your favorite thing about — I know you just moved up there. What’s kind of your favorite Boston thing so far?
JAMI: I’d say just being in the city to me is just exhilarating. Because I’m kind of from — I grew up in a small Florida town and kind of moved around Florida a lot where we didn’t really have that metropolitan feel. And of course the weather here. And summer/spring is very nice. Winter is a little bit challenging. But I love public transportation so getting on the train everyday to me is exciting.
PAIGE: Boston public transit, I had no idea how spoiled i was until I moved away from Boston, but it’s pretty much, once you get out of the Boston, New York, DC corridor, once you get out of there the rest of the country does not have the kind of public transport that the northeast has, and I had no idea.
JAMI: No. Yeah.
PAIGE: But I’m surprised you say summer. Well, I guess you’re from Florida. Honestly the worst part of New England weather to me is the hot, sticky summers, but Florida definitely takes the cake on that one.
ANGELA: Yeah.
JAMI: Right. Right. Yeah, it’s not that — I mean it’s been high 80s but it’s not that bad.
PAIGE: We also ask a couple of things that people do. So what else do you do with your free time?
JAMI: Well, I have a little dog named Penny so I like to spend time a lot with her. I like to research old train stations, which is kind of silly, but it’s kind of like a new thing since I’ve moved up here to New England. There’s a lot of — obviously a lot of history, a lot of hold history. But a lot of old train stations that have either been renovated into other things or they’re just kind of missing and you just kind of see pieces of them and you want to know why. Like why, what happened? And things like that.
PAIGE: That’s really fascinating. You should blog about that.
JAMI: It’s such a random thing. I don’t know why I’m so obsessed with it.
ANGELA: Yeah, no, seriously. Yeah, if you started a blog I bet you could get-
PAIGE: I would follow that.
ANGELA: Click revenue, because trains and stuff like that is really a popular thing.
JAMI: Probably.
PAIGE: Even if you’re in a for a casual ride, the Rail to Trail project that has happened through most of New England is fascinating.
JAMI: Yes.
PAIGE: And you get to go by a lot of those old train stations and things.
JAMI: Yes, we have one that actually runs right by our house. We haven’t been since fall, but we take the dog and it’s very interesting. Some of the old signals are even still there. And the old crossover bridges. It’s very cool.
PAIGE: New England is a really fascinating place for history. Definitely. Highly recommend. So you’re teaching yourself right now. What are some of the things that are hardest for you, even just learning like — is it jus getting your head around the logic of it? Like understanding terms? Like what is a variable? What is a function? Like what’s your sticking points and how are you getting over them or how are you not?
JAMI: I think it’s more the logic, because I’m kind of still in the midst of doing some of the online courses for Javascript. And it’s just — I don’t know if it’s the math portion or it’s just kind of all of it at once, like the, you know, if L statements and things like that. Sometimes it kind of throws me around. It’s just trying to figure it out. They give you a sample. Okay. Here’s some code, now try to fix it. Or you’ve got to write this yourself. here’s your variables and write it. So it’s just digging in and trying to figure it out is the best way how I get through it.
PAIGE: I like that. I also usually encourage people who are new to programming to write it out in plain English first.
JAMI: Uh-huh.
PAIGE: And then try to make it into code.
JAMI: Right.
PAIGE: Because if you write the logic in a way that you understand it and then translate, it can kind of help that step. Are you just doing stuff online? Are you going to meetups or anything?
JAMI: I haven’t gone to any meetups yet. I know there are a lot in the Boston area. I know there are couple of, especially for women they’re actually creating — there’s a lot of groups that are actually for women that want to code and you could actually get involved in these groups and they do meetups. And basically at any level you could just want to learn and you could get into the groups and start working with them and learn more. And that’s something I’d love to do. I just haven’t had the chance right now, unfortunately.
PAIGE: I definitely encourage you to check that out. I’m actually the director for Women Who Code Portland and I know that we have a Boston chapter.
JAMI: NIce.
PAIGE: And I think Girl Develop It is out there if you want something more workshoppy.
JAMI: Right.
PAIGE: I highly recommend both of those.
ANGELA: Do you have, at your job, are you the only technical writer or is there somebody else that you — that also does that?
JAMI: No, I am the sole technical writer. I was actually hired on last year to help their documentation section. They were using and old Drupal platform and they wanted something more robust and more modern that could actually kind of help users navigate it through better. So that’s kind of where I came along. I’ve had a little over six years’ experience as a tech writer so I kind of brought my expertise in and helped them find the MadCap Flare tool to build their documentation set. So I’m the sole person on that — in that full team right now.
ANGELA: Job security.
JAMI: Yes.
ANGELA: Have you ever met another technical writer? Like with either a partnering company or a client that has a technical writer?
JAMI: Yes.
ANGELA: Yeah? Is that-
JAMI: Yes.
ANGELA: Are you guys able to like share hidden jokes and — I don’t know.
JAMI: Sometimes. Yeah, so my last job before this one I was actually on a technical writing team. We had — I think at one time we had about five writers and a supervisor that we’d all been — you know, we were all tech writers. So we all knew the jokes, whether it be about a specific programmer or just the logic of things. Of, oh like, oh your authoring tool is doing something weird again. Oh no. You know, things like that. It’s mostly just weird little quirks.
ANGELA: Uh-huh.
PAIGE: Did you ever put easter eggs inside technical documentation like we do with programs?
JAMI: Uh, no I haven’t.
PAIGE: You should consider it.
ANGELA: Yeah. You work on that. We’ll check back with you in six months.
JAMI: Okay. Yeah.
ANGELA: No, just kidding.
PAIGE: So, if someone was listening to the show and is a writer currently, they’re freelance or whatever they’re doing, or maybe they’re finishing a degree or something and they wanted to get into technical writing, what kind of advice would you give them?
JAMI: I would just say to get out there and read as much as you can about it. I mean, from my perspective, I didn’t have an actual formal tech writing training. I didn’t go to school for it. So you kind of have to be tech savvy in some sense, and you have to be willing to learn. You have to be open minded that things are going to change and that you have to kind of be up and current and to — you know, whether it be the current authoring tools platforms that are available or the other kinds of ways that you can make your documentation better. And it’s just to get out there and try to create something. Take online courses or tutorials and just do what you can. Because this is just how you can learn.
PAIGE: Do you have any courses you might recommend for technical writing?
ANGELA: Maybe not yet. I think you’re probably in the early stages of figuring out what it is that would have been helpful?
JAMI: Yeah. And I mean, back when I was starting to learn six years ago there wasn’t — I don’t think there was a whole lot free online, you know, tutorials like there are now. But there are books out there that you could look in technical writing. I believe there’s a site called technicalwriting.com, if that’s still available. I”m not sure. BUt I think that’s a community so you can share ideas and things like that.
PAIGE: We’ve had some people give the advice before of people who are even just looking to get into development to — if they wanted to kind of dip their toes in open source that actually doing documentation work for open source projects is valuable. Do you think that would be valuable for a technical writer as well?
JAMI: Yes, definitely. If you really want to just get your experience, get your foot in the door, and if you’re willing to either volunteer your time or something like that, it definitely — definitely find — or a startup. Or something like that, that really could use some documentation help. ANd if you’re open to learning along the way with them.
PAIGE: So just like development, just get your feet in and do the work and it will pay off.
JAMI: Correct.
ANGELA: Thank you for listening to this episode of Women’s Tech Radio. Don’t forget you can find the full transcription either in the YouTube description or on JupiterBroadcasting.com. Find the Women’s Tech Radio dropdown and you can also listen to our back catalogs. We have a lot of amazing shows on there.
PAIGE: So many great women have been on this show. You can also find us on iTunes. If you have a moment, leave us a review. We’d love to hear what you think. You can also contact us by dropping us a line at WTR@JupiterBroadcasting.com or followng us on Twitter, @heywtr. Thanks so much for listening.

Transcribed by Carrie Cotter | Transcription@cotterville.net

The post Technical Writing | WTR 37 first appeared on Jupiter Broadcasting.

]]>