How to make your ideas stick. Part 1/7: Introduction

This is the first in a series of posts on my journey as a technical writer to improve how I deliver ideas to readers’ minds and make them stick there. You never know where you’ll discover a gold nugget. I found Chip and Dan Heath’s work by chance in a Google docs slide template called MakingContinue reading “How to make your ideas stick. Part 1/7: Introduction”

Installing minikube and agones

Tonight, I installed Agones, a library for hosting, running and scaling dedicated game servers on minikube, a local instance of Kubernetes. I’m doing this to: Get more hands-on experience running Kubernetes. Set up a development environment for my son, who is a game developer. Try my hand at developing a simple app or microservices. I also logged aContinue reading “Installing minikube and agones”

Silicon Valley is dead! Long live Silicon Valley!

TLDR Remote work and the current health crisis has made Silicon Valley obsolete. Companies and workers are moving away in droves. Will they find a new place like Silicon Valley? Yes and No. The end of the health crisis will enable a resumption of office work. However, having invested in and adopted remote work, organizationsContinue reading “Silicon Valley is dead! Long live Silicon Valley!”

Why I write about me instead of you

As a technical writer, I’m accustomed to telling users what to do using imperative phrases such as “do this or do that.” More recently, in my tech docs, I’ve adopted the practice of directly addressing the user by saying “you.” Many organizations have embraced this practice because it improves comprehension and establishes a warmer relationshipContinue reading “Why I write about me instead of you”

Overview: Write the Docs, Portland 2020

This year’s WTD conference was online/virtual only. This shift to virtual conferences make them more inclusive and accessible to attendees whose work, personal responsibilities, finances, or other constraints would normally discourage them from participating. Although this conference was well-attended by folks on the West Coast, by my estimate, half of the attendees were from otherContinue reading “Overview: Write the Docs, Portland 2020”

Unconference

One of the nice things about the Write the Docs – Portland conference two weeks ago, was it’s unconference. An unconference is a participant-driven meeting. The term “unconference” has been applied, or self-applied, to a wide range of gatherings that try to avoid hierarchical aspects of a conventional conference, such as sponsored presentations and top-downContinue reading “Unconference”

I pulled it

This morning, I wrote the conference organizer and pulled my presentation. My early morning thoughts had revealed to me how I had missed the mark. During the process of creating the presentation, I had this uneasy sense that I was missing something. My early morning thoughts crystallized my understanding of what was amiss and IContinue reading “I pulled it”