Note: This is a repost of my Fail Mail newsletter.
I recently spoke at EmberFest about community documentation. In this talk, I brought up a failure I would like to share with all of you as well.
Every week I help co-edit the Ember Times newsletter. This involves editing, reviewing and also writing sections of the newsletter. One week I decided to write about some amazing initiatives to improve the documentation for Ember CLI. This is something that was long overdue and I was honestly quite excited about this.
So, I wrote a small section about this news and submitted the PR. It was accepted and eventually, the newsletter was sent out to all of our subscribers and posted on the Ember Blog as well. I shut down my laptop and went on with the rest of my day.
Next day I returned to a GitHub notification. There seemed to be a hotfix to the newsletter. In the PR description, it said:
Update some blog text to be neutral. I understand that the phrasing was meant as a joke/play on words, but I associate this phrase with causing a lot of harm to a lot of people.
I panicked and checked the diff. Sure, it was my section that was the issue. Before I looked around two other core team members agreed that this was an issue.
By me not being a native speaker I had overlooked a critical political issue. In my eagerness, I wrote that there were initiatives to "make the Ember CLI documentation great again!". At the moment I wrote it I had no idea that this was ever going to be perceived as political, but I was very wrong.
Stuff like this will always happen and I honestly didn't intend to offend anyone. But now I try to be a bit more careful reading my texts before submitting a PR.
Want to read more like this? Subscribe to Fail Mail!
Do you want to share your fails with me and the Fail Mail community? Write a comment or write me on Twitter (My DMs are open) and I'll include your fails in the next newsletter.