« Oatmeal

In reply to: https://blog.mozilla.org/opendesign/future-mdn-focus-web-docs/

I’m hella excited to see mozilla focusing on web documentation. The lack of diversity in tech is an issue that has rightly receiving a heap of attention lately. I think it deserves even more.

Perhaps a major issue in the tech. community (especially in the open source world) is absolutely befuddlingly terrible documentation? 🤷‍♂️

Terrible documentation means stuff is harder to pick up. When stuff is hard to pick up and learn, some folks are forced out. There is no need for tech. to be an occult dark art, with secrets kept in caves dank and dark.

I hope that Initiatives like mozilla’s will lead to more accessible technical documentation. More accessible technical documentation is a step in the right direction, because it empowers more folks to pick up dem techy skills. This is by no means a quick cure to the unbearable whiteness of tech, but it is a step in the right direction.

Writing this, I realize I should probably practice a bit more of what I preach, and document some more stuff.

Post a response on your own site? Send me a webmention!