Alyssa Rock
Technical Writer
Alyssa Rock
Technical Writer
March 12, 2022 Working as a technical writer in open source

As part of a work project, I created a comprehensive list of possible tasks that tech writers working in OSS might possibly work on. As part of this project, I also created a document explaining the unique challenges faced by writers working in OSS and a set of guiding principles for scoping technical writer work.

May 17, 2021 The power of personas

Personas make it easy for technical writers to identify the audiences they are creating documentation for. Personas get me maybe 65-75% of the way there in terms of understanding my audience.

March 15, 2021 Creating effective community doc events (a case study)

The Salt project’s recent documentation jam was a huge success in terms of participation, productivity, diversity, and positive buzz. But why? In this blog entry, I break down the many elements that led to such a successful event.

December 29, 2020 The life-changing magic of a tidy kanban board

I’ve gone from actively hating our documentation issue backlog to feeling proud of our issue triage process. In this post, I share key insights and best practices that I’ve learned about issue triage.

December 13, 2020 Getting started in open source as a new tech writer

Contributing to open source projects gives you valuable work experience and helps you build your professional network. Read my advice about using open source to land your first technical writing job.

December 6, 2020 Attracting active contributors to open source (a case study)

“I came for the project, but ended up staying for the community.” Read my advice for attracting more active contributors to open source using lessons learned from the Good Docs project.

November 22, 2020 Tips for fighting impostor syndrome

It’s common for people to experience impostor syndrome while working in tech. In my latest blog entry, I discuss how I personally use CBT techniques to redirect negative patterns of self-talk into healthier directions.

November 12, 2020 Documentation can help close sales (a case study)

While it can’t really make up for a poor product UX design, good documentation can help tell a story for prospective customers about how easy the product is to use.

November 10, 2020 Why do I sometimes forget how awesome usability testing is?

Why do I sometimes neglect docs usability testing? Join me as I examine my personal barriers to testing and renew my commitment it.

November 8, 2020 Hi, I’m Alyssa

Welcome to my new portfolio site and blog! This is going to be a professional blog that I’ll use to record thoughts I have related to tech writing, with a focus on docs in open source.