Posted in 2017

Breaking Cliques at Events: The Snowball Rule

I’ve been going to professional events for a number of years, and one of the trickiest dynamics I have seen is that most events develop an “insiders” group who has been going for a long time. These groups tend to feel like exclusionary cliques for first-time attendees, and actively hurt the community’s goal of inclusion.

Read more ...


The Pac-Man Rule at Conferences

I firmly believe that conferences can provide a lot of value for people in an industry. Conferences allow people to create a network, which helps them feel integrated in a community and profession.

Read more ...


Documentation is JSON for the Brain

When you are writing software, you build a mental model of the program in your brain. This is how you make decisions and reason about how the program might work, how data flows, or what designs make the most sense.

Read more ...


“My Code is Self-Documenting”

Self-documenting code is one of the biggest documentation myths in the software industry. This view generally conflates documentation with code comments. I’d like to make two arguments in this post:

Read more ...




Hey there! I'm Eric and I work on communities in the world of software documentation. Feel free to email me if you have comments on this post!