Alyssa Rock
Technical Writer
Alyssa Rock
Technical Writer
About me

I’m a senior technical writer with experience documenting software and web apps. I serve as the chair of the Good Docs Project, an open source project dedicated to improving documentation in open source communities.

  • Title Staff Technical Writer
  • Company VMware
  • Work experience 8 years
  • Taught writing 6 years
  • Residence Springville, UT
Alyssa at a glance
Audiences

I love writing for network engineers and folks in DevOps, SecOps, and IT.

Technologies

I’m comfortable with Python, HTML/CSS, JavaScript, and UNIX-based systems.

Types of docs

I excel with conceptual docs, procedures, getting started guides, and tutorials. Currently learning API docs.

Companies

I’ve worked for SaltStack (acquired by VMware), Micro Focus, FlexSim Software Products, and Yahoo! Inc.

Testimonial
Not only is Alyssa a very good technical writer, she shows bucket loads of initiative and follow through. She thinks up high value ideas for the project and then follows through on implementing them. She enables and empowers others by helping them refine their ideas, helping where appropriate. She shows leadership where needed. She is good at prioritizing her time, focusing her energy where she can be most impactful. She welcomes feedback and is great at accepting it (which is especially important for tech writers).
Cameron Shorter
Previous chair of the Good Docs Project
Hobbies and interests
Music omnivore
Film afficionado
Puzzle and game lover
Food tourist
Success stories

Major installation guide improvements saved time and improved customer satisfaction

The installation guide for our core product at SaltStack received a lot of negative feedback for being difficult to use. It also took several hours to update manually every release cycle. Over 3 months, I collaborated with a team of technical writers and site reliability engineers to overhaul the installation guide. We focused on researching pain points with customers to improve the accuracy and usability of the core content. We also implemented a new theme and automated the CI/CD pipeline for package delivery and publishing. Our improvements had several positive results, including:

  • Average end-user satisfaction scores immediately improved to 3.7 out of 5, up from 2.8 on average in previous surveys.
  • The number of end-users giving the lowest satisfaction score possible dropped to zero.
  • Estimated release cycle time reduction of 56-95 human resource hours. At 3 releases a year, this translates to a time savings of 285 hours annually, freeing up resources for other business initiatives.

 

Migrated 285 knowledge base articles in one month with no data loss

The Support team at SaltStack determined their knowledge base was not meeting internal business requirements and chose a different platform to reduce expenses. The project also needed to be executed quickly before our license expired. Using my previous experience participating in several major migration projects, I helped spearhead and execute a plan to migrate the company’s knowledge base articles to a new cost-saving platform. The results of these efforts were:

  • 285 knowledge base articles were successfully migrated on time without any data loss in only one month.
  • The new platform not only saved costs, but integrated well with existing support team processes.
  • The Support team sponsored me for recognition as the “Saltiest Employee of the Month.”