What Every Community Needs

Yesterday I wrote that every project should make its governance discoverable. Here are a few other things that would help programming communities:

  • tldr pages: one-line manual pages with practical examples.

  • explainshell: automated drill-down explanations of commands.

  • this vs. that: short explanations of the differences between things that are frequently confused.

  • a glossary: preferably subsetted from a shared one because why reinvent the world?

  • concept maps: or other remixable illustrations of key ideas.

Please let me know what else is on your list: I’m always grateful for pointers.

In the wake of posts about Shopify's support for white nationalists and DataCamp's attempts to cover up sexual harassment
I have had to disable comments on this blog. Please email me if you'd like to get in touch.