@davidbisset That's great resource, thanks for sharing! I use the alexJS linter to flag that kind of language when I wrote documentation since I heard a talk about accessible documentation where that was mentioned! It was a big 💡moment for me - I worked hard on removing these phrases from my vocabulary when I still did dog training, but until the talk it didn't really click for me that it's also a good idea to do that in documentation and things like that 🤦♀️
@davidbisset For some reason I thought the site was going to be "input your docs url here and we'll show you ever time you've used the words 'just' 'simple' 'easy' and their variants" and now I'm sad it doesn't
@davidbisset this drives me nuts in documentation because it assumes a level of knowledge on par with the person who wrote the docs, which is rarely the case.
What I love when I read docs is absence of justs and simplies, but instead something like "this doc assumes that you have some x knowledge and if you don't you may want to start at (link to x knowledge)"
@jjcelery@davidbisset@whalecoiner For what it’s worth, this makes technical books unreadable too, especially when it comes with a jaunty conversational style. Just give the facts, don’t tell me how easy it really is and that I’ll hopefully ‘get it’ later on.
Add comment