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)

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

@@ -1,12 +1,11 @@
 """This script generates the python XAP client.
 """
-from qmk.constants import QMK_FIRMWARE, GPL2_HEADER_SH_LIKE, GENERATED_HEADER_SH_LIKE
-
-from qmk.xap.common import latest_xap_defs, render_xap_output
-from qmk.commands import dump_lines
-
 from milc import cli
 
+from qmk.commands import dump_lines
+from qmk.constants import QMK_FIRMWARE
+from qmk.xap.common import latest_xap_defs, render_xap_output
+
 
 @cli.subcommand('Generates the python XAP client.', hidden=False if cli.config.user.developer else True)
 def xap_generate_python(cli):
@@ -14,9 +13,7 @@ def xap_generate_python(cli):
 
     parent = QMK_FIRMWARE / 'lib' / 'python' / 'xap_client'
     for name in ['types.py', 'routes.py', 'constants.py']:
-        lines = [GPL2_HEADER_SH_LIKE, GENERATED_HEADER_SH_LIKE]
-
         output = render_xap_output('client/python', f'{name}.j2', defs)
-        lines += output.split('\n')
+        lines = output.split('\n')
 
         dump_lines(parent / name, lines)