accessible visual language

[neal-timpe]

Create a warning for only using visual words.
https://issues.redhat.com/browse/CCSENABLE-501

[github-actions]

🎊 Navigate the preview: https://redhat-documentation-vale-at-red-hat-579.surge.sh 🎊

[github-actions]

Click here to review and test in web IDE:

[neal-timpe]

These are good suggestions. Sorry I was on pto for a couple of weeks. I didn't meant to ignore this. :)

[aireilly]

Here is another approach. We have a new Error rule that provides context to the user about error terms. See https://github.com/redhat-documentation/vale-at-red-hat/blob/main/.vale/styles/RedHat/DoNotUseTerms.yml

Could work here too. For example,

---
extends: substitution
ignorecase: true
level: suggestion
link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/visuallanguage/
message: "%s"
swap:
  # Error messages must be single quoted.
  above: 'Try not to use "above". Visual language may be inaccessible to some readers. This can hinder comprehension and inclusivity in your content.'
#etc

Kind of a hack. It's a sub rule that doesn't have a substitution suggestion. Just an explanation. 🤷

[neal-timpe]

That actually sounds like what I want to do. There are some items for which I have a swap. But there are others, like colors, where writers really need to be warned not to use them in certain cases.

[neal-timpe]

@aireilly I think this one i ready for another look. If you're okay with it, I'm happy to squash.

[neal-timpe]

@aireilly Added your last update and squashed.

[aireilly]

/lgtm

🥇 thank you for hanging in there Neal! The effort is much appreciated.