Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 5,000+ subscribers

Stitcher radio

Search results

I'd Rather Be Writing

Presentation recording: Move Fast And ... Document Things? Lessons learned in building documentation culture at a startup, by Ruthie Bendor
Presentation recording: Move Fast And ... Document Things? Lessons learned in building documentation culture at a startup, by Ruthie Bendor
During the May WTD meetup, Ruthie Bendor, a web engineer, gave a presentation titled Move Fast And ... Document Things? Lessons learned in building documentation culture at a startup. This post contains the audio and video recording of her presentation.
Presentation recording: Two Great Teams that Work Great Together: Bridging the Gap Between Documentation and Support
Presentation recording: Two Great Teams that Work Great Together: Bridging the Gap Between Documentation and Support
At the May WTD meetup, Neal Kaplan gave a presentation titled Two Great Teams that Work Great Together: Bridging the Gap Between Documentation and Support. This post contains the audio and video recording of the presentation.
Recent Write the Docs presentation recordings
Recent Write the Docs presentation recordings
We recently hosted a Write the Docs meetup in Redwood City with a couple of excellent presenters. Recordings of their presentations are below. I also explain a bit about my new lapel mic and recording process.
Some post-STC Summit thoughts
Some post-STC Summit thoughts
I attended the 2016 STC Summit in Anaheim, California this year. This is a brief, rambling post that recaps some of my thoughts and experiences.
Slides for Writing Tech Docs Like a Hacker with Jekyll presentation
Slides for Writing Tech Docs Like a Hacker with Jekyll presentation
Here are the slides for my STC Summit 2016 talk on Writing Tech Docs Like a Hacker with Jekyll presentation. In this presentation, I introduce the tech comm conference attendees to Jekyll and how it can be used for authoring technical documentation. I'll try to demo a few of the tasks I describe.
Slides for Documenting REST APIs Workshop — 2016 STC Summit Anaheim, Calif.
Slides for Documenting REST APIs Workshop — 2016 STC Summit Anaheim, Calif.
Here are my slides for the Documenting REST APIs workshop I'm giving at the 2016 STC Summit in Anaheim, California. The workshop lasts 3.5 hours. These slides cover a host of topics, including how to use APIs, how to document APIs, how to publish APIs, and more. There are lots of hands-on activities throughout. Some of the activities involve using the command line, the Chrome JavaScript Console, Postman, Git, reading JSON, and more.
How do you establish more context in a topic-based writing model?
How do you establish more context in a topic-based writing model?
I'm trying to come up with way of providing more context for users in documentation. Providing context is essential to helping users understand how all the various pieces fit together. Without context, the information becomes fragmented and seems unorganized, maybe even random. I've tried a couple of approaches to establishing context -- consolidating the information more while I draft it, and also putting maps with signposts throughout the content. I still have a ways to go to figure this out.
Getting sharp, clear text in screen captures — and making sense of Retina displays
Jekyll Conf 2016 slides and video: Overcoming Challenges in Using Jekyll for Tech Docs
Jekyll Conf 2016 slides and video: Overcoming Challenges in Using Jekyll for Tech Docs
My slides and video for Jekyll Conf 2016 are available below. In this presentation, I talk about the various challenges I've had in using Jekyll for technical documentation. I explain my attempts to overcome requirements with everything from conditional filtering to generating PDFs, publishing across different environments, re-using content across projects, templatizing notes and alerts, and more.
Creating professional looking graphics in the easiest, simplest way possible
I recently gave a lightning talk at a Write the Docs meetup in downtown San Francisco. My talk was titled Creating professional graphics in the easiest, simplest way possible. This post contains the slides, recordings, and other notes.
Visual communication overview
In this series on visual communication, I'm going to explore in a variety of topics in visual communication, such as screenshots, diagrams, concept illustrations, SVG graphics, translation, image file management, graphics programs, getting professional-looking images, images on mobile displays, print versus online images, design principles, and more.
Three types of knowledge every technical writer needs to be successful
Three types of knowledge every technical writer needs to be successful
Today I was thinking about the most important element in a successful technical writing career, and I think it's knowledge. The more you know, the better information you can write. There are at least three main types of knowledge: product knowledge, technical knowledge, and user knowledge. Just knowing one of the three won't provide you with the kind of information you need to write good documentation.
Recording of WTD presentation on Video Documentation, by Alicia Avrach
Recording of WTD presentation on Video Documentation, by Alicia Avrach
Alicia Avrach, a content strategist at ThoughtSpot, gave a presentation about video documentation at a recent Write the Docs San Francisco meetup. In this presentation, Alicia covers all the aspects of video production, from scripting to recording, post-processing, publishing, and more.
Recording of STC-SV presentation on the Shape of a Modern Technical Communication Organization, by Sanborn Hodgkins
Recording of STC-SV presentation on the Shape of a Modern Technical Communication Organization, by Sanborn Hodgkins
Sanborn Hodgkins gave a presentation to the STC Silicon Valley chapter called Shape of a Modern Technical Communication Organization on April 18. In the presentation, she highlights the variety of roles — editor, videographer, information architect, content strategist, manager, writer, tools developer, and others — that tech comm organizations need to thrive.
Seeing things from the perspective of a learner
Seeing things from the perspective of a learner
To write documentation that users find helpful, you have to understand the mindset of someone who doesn't possess all the knowledge that you have. You have to understand what it's like not to know -- even not to know some of the most basic assumptions. Trying to capture this state of un-knowledge and remember all the questions you have is critical to writing documentation that speaks to this type of user.

subscribe via RSS