November 3rd & 4th, 2023
Love SeaGL and want to help out? Get Involved

Verbose mode: an exploration of programming languages and craft

SeaGL 2017

I want to talk about knitting technical writing and how it has changed based on the education level we provide in schools, and what that means for technology. The reason mainstream patterns are hard is because they assume a base level of knowledge in their users, and because they are so concerned about brevity that they omit context. This talk explains how the meaning of “common knowledge” changes, but our standards for interfaces and documentation don’t keep up.

Come to this talk because you want to learn about how analytics can make your life easier, what that has to do with documentation, and my top tips for gauging your audience’s experience and comfort level.

This talk is an analysis of how education, assumptions, and technological constraints can make systems of learning accessible or impenetrable, and what we can do about it.