Integrate rules for validating AsciiDoc

[themr0c]

Test and integrate modular docs rules created by @jhradilek: https://github.com/jhradilek/vale-modular-docs

---

Edit from @rohennes - we are working on https://github.com/rohennes/ocp-rules to meet the same ask, so using this issue as a tracker for the work on this repo

[themr0c]

Not every content follows the modular docs guidelines. Therefore, ensure they don't generate error or warnings, at least with the default configuration file.

[rohennes]

@jhradilek - I have been working on what I think is the same idea. See this repo: https://github.com/rohennes/ocp-rules Great minds think alike! :-p

The goal is for this rule set to exist as a separate package to the RedHat rule set. If it's OK with you, can I incorporate any rules in your repo that I didn't think of into my repo? I think a few of the rules are the same actually... e.g. check for context variable in IDs.

Or feel free to create a PR if you want to add to my repo. My repo is slightly OCP specific at this point but I am trying to make it more generic so it can be applied across teams. FYI - the rules in my repo apply to modules only.

[rohennes]

For the record, not taking anything from Jaromír's repo at present. Two of the rules in Jaromír's repo relating to modules are present in the ocp-rules repo. Although it is worth noting these rules use a different style: they extend the conditional style rather than the existence style.

The other two rules are for assemblies, but also worth noting if we ever get around to making rules, or a rule-set, for assemblies.