Align client/docs gen with recent changes

lib/python/qmk/cli/xap/generate_docs.py

@@ -1,16 +1,18 @@
 """This script generates the XAP protocol documentation.
 """
 import hjson
+
+from milc import cli
+
 from qmk.constants import QMK_FIRMWARE
 from qmk.xap.common import get_xap_definition_files, update_xap_definitions, render_xap_output
-from milc import cli
 
 
 @cli.subcommand('Generates the XAP protocol documentation.', hidden=False if cli.config.user.developer else True)
 def xap_generate_docs(cli):
     """Generates the XAP protocol documentation by merging the definitions files, and producing the corresponding Markdown document under `/docs/`.
     """
-    docs_list = []
+    versions = []
 
     overall = None
     for file in get_xap_definition_files():
@@ -22,17 +24,12 @@ def xap_generate_docs(cli):
                 overall['response_flags']['bits'][str(n)] = {'name': '', 'description': '', 'define': '-'}
 
         output_doc = QMK_FIRMWARE / "docs" / f"{file.stem}.md"
-        docs_list.append(output_doc)
+        versions.append(overall['version'])
         output = render_xap_output('docs', 'docs.md.j2', overall)
         with open(output_doc, "w", encoding='utf-8') as out_file:
             out_file.write(output)
 
     output_doc = QMK_FIRMWARE / "docs" / "xap_protocol.md"
+    output = render_xap_output('docs', 'versions.md.j2', overall, versions=versions)
     with open(output_doc, "w", encoding='utf-8') as out_file:
-        out_file.write('''\
-<!-- This file is generated -->
-''')
-
-        for file in reversed(sorted(docs_list)):
-            ver = file.stem[4:]
-            out_file.write(f'* [XAP Version {ver}]({file.name})\n')
+        out_file.write(output)