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”
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”
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!”
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”
If you want to use something more pomodoro than Fedora’s built-in timer, try Solanum. Divide your work into four 25 minute sessions with 5 minute breaks in between. One longer break after four sessions.
You don’t need to download and install a Pomodoro timer. Just use the one built into Fedora.
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”
Today is Red Hat’s “Day of Learning.” We are encouraged to dedicate this day to learning. This past year, I’ve been mentoring one of my peers. Earlier this week, I asked her to share her thoughts on what went well and what could be better. I got her notes this morning and spent some timeContinue reading “Day of Learning”
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”
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”