3 ms·
> This is the release notes of a free software project. Ironically, this statement is _also_ incomplete. It is missing key details that are meant to be inferre
by nightowl_games 4y ago
> This is the release notes of a free software project.
Ironically, this statement is _also_ incomplete. It is missing key details that are meant to be inferred from 'free software project'.
> accusing the authors of "gatekeeping"
"Accuse" illuminates the core failure on my part. Gatekeep was the wrong word choice, as it implies _intent_. I do not believe that the release note writer has intentionally left out details.
I'm pointing out that many of us rely on too much assumed knowledge in our writing.
I personally make an effort to write and speak in manner that is understandable even to someone with low domain knowledge and context. I have observed that this skill has been important to my career. Because of this, I am particularly aware of instances where a writer has left out key details in their writing, because I often fill that void for the other stakeholders.