Skip to main content
by Janet Riley

Dan Slimmon: An Incident Command Training Handbook

Tags: ,

Dan Slimmon: An Incident Command Training Handbook

Summary

How to structure and lead an incident response. The five questions of a status update. How to manage information flow effectively.

Slimmon's writing style is direct and simple. It's a mid-length article with some detail, but you could follow it in a high-stress situation (like mid-incident) and benefit immediately.

Best case scenario is to have the whole team read it ahead of time to understand the structure. When it's showtime everyone can slide into their roles and know their responsibilities.

Excerpts

An Incident Commander’s job is to keep the incident moving toward resolution. 
But an Incident Commander’s job is not to fix the problem.

As Incident Commander, you shouldn’t touch a terminal or search for a graph 
or kick off a deploy unless you’re absolutely the only person available to do it. 
This may feel uncomfortable, especially if your background is in engineering. 
It will probably feel like you’re not doing enough to help. 
What you need to remember is this: whatever your usual job, when you’re the Incident Commander, your job is to be the Incident Commander.

Managing information flow is the single most important responsibility of the Incident Commander.

Takeaways

Sometimes the most effective thing you can do is coordinate the experts.

Docs for Developers: An Engineers Field Guide to Technical Writing

Tags: , , ,

Docs for Developers: An Engineer's Field Guide to Technical Writing

Publisher's Page

Author: Jared Bhatti, David Nunez, Jen Lambourne, Zachary Sarah Corleissen, Heidi Waterhouse

Summary

How to write maintainable docs that help your customers use your software.

Excerpt

"Docs for Developers demystifies the process of creating great developer documentation, following a team of software developers as they work to launch a new product. At each step along the way, you learn through examples, templates, and principles how to create, measure, and maintain documentation, which you can adapt to the needs of your own organization."

Takeaways

This struck me as the devops of documentation - turn these high level ideas into something we can live in. On my To Read pile.

Michael Lopp: Out Loud

Tags:

Out Loud

Author: Michael Lopp

Summary

Tips on delivering a compelling presentation from Rands in Repose. Editorial choices, practicing out loud, consolidation, and timing.

Pixar in a Box

Tags: ,

Pixar in a Box: the art of storytelling

Author: Pixar

Summary: A Khan Academy course. Pixar walks us through building stories, with an emphasis on movies. Character development, plot, reinforcing the story with visual choices, pacing, and making a pitch.

This recommendation was in an article on more compelling technical presentations. Not really a fit for the format and time limits of a tech talk, but still interesting.

Tanya Snook: Storytelling

Tags: ,

Storytelling: Building Compelling Stories for Any Audience and presentation notes

Author: Tanya Snook

Excerpt: "This presentation explores storytelling at work. Not milk-and-cookies-time-around-the-campfire storytelling, but using storytelling methods to build and deliver messages in a compelling way. Using empathy to draw your audience in and help them to hear your message, and hopefully create a memorable experience in the process."

Cederic Chin: An Easier Method for Extracting Tacit Knowledge

Tags: ,

An Easier Method for Extracting Tacit Knowledge

Author: Cederic Chin

Summary

How do you distill expertise into teachable lessons? Chin explains Applied Cognitive Task Analysis framework (ACTA) in part 5 of his series on tacit knowledge.

ACTA was created by Laura Militello and Robert Hutton. They lead experts through four processes:

  • a task diagram to create the big picture of the process

  • a knowledge audit to identify how expertise is used in the process

  • a simulation interview, describing how they used their expertise in an incident

  • a cognitive demands table, that synthesises the prior steps

The cognitive demands table becomes the basis for training materials.

Takeaways

The simuation interviews remind me of post-incident retrospectives.

This would be handy for creating troubleshooting docs, to help flush out the knowledge we don't realize we have.

Michael Lopp: How Not to Throw Up

Tags: , ,

How Not to Throw Up

Author: Michael Lopp

Summary

Practice endlessly and improvise. Practice beforehand until the content moves from the planning side of your brain to the other side.

During the presentation, adapt your manner to the the moment. Who's in the room? What's the energy level? Make room for them to participate.

Excerpt

"This article is about presentations, not content. Both are equally important, but I’m not here to help you write your content, I’m here to transform that content into a presentation that doesn’t suck."

"Confidence is going to come not when you memorize your slides, but when you move the content from one side of your brain to the other. Right now, your slides are sitting in the linear left side of your brain, the practical side. This is a fine place for the slides to be while you’re creating them, but before you get up on stage, you need to move them to the right side of your brain, the creative side. You need to be able to feel your slides."