validate-modules: support plugin see-also (#80244)

changelogs/fragments/80244-validate-modules-seealso.yml

@@ -0,0 +1,2 @@
+minor_changes:
+  - "validate-modules sanity test - support the ``plugin`` see-also part of the semantic markup specification (https://github.com/ansible/ansible/pull/80244)."

test/integration/targets/ansible-test-sanity-validate-modules/ansible_collections/ns/col/plugins/modules/sidecar.yaml

@@ -17,6 +17,9 @@ DOCUMENTATION:
       default: foo
   author:
   - Ansible Core Team
+  seealso:
+  - plugin: ns.col.import_order_lookup
+    plugin_type: lookup
 
 EXAMPLES: |
   - name: example for sidecar

test/lib/ansible_test/_util/controller/sanity/validate-modules/validate_modules/schema.py

@@ -12,6 +12,7 @@ from functools import partial
 from urllib.parse import urlparse
 
 from voluptuous import ALLOW_EXTRA, PREVENT_EXTRA, All, Any, Invalid, Length, Required, Schema, Self, ValueInvalid, Exclusive
+from ansible.constants import DOCUMENTABLE_PLUGINS
 from ansible.module_utils.six import string_types
 from ansible.module_utils.common.collections import is_iterable
 from ansible.module_utils.parsing.convert_bool import boolean
@@ -172,6 +173,11 @@ seealso_schema = Schema(
                 Required('module'): Any(*string_types),
                 'description': doc_string,
             },
+            {
+                Required('plugin'): Any(*string_types),
+                Required('plugin_type'): Any(*DOCUMENTABLE_PLUGINS),
+                'description': doc_string,
+            },
             {
                 Required('ref'): Any(*string_types),
                 Required('description'): doc_string,