Handle UTF-8 encoding issues in reference page generation

Updated the gen_ref_pages.py script to include error handling for UTF-8 encoding when reading markdown files. Files that cannot be decoded are skipped, and a warning is printed to inform the user.

Author: jmcouffin

docs/gen_ref_pages.py

@@ -35,5 +35,10 @@
     nav_file.writelines(nav.build_literate_nav())
 
 for md in Path(".").glob("*.md"):
-    with mkdocs_gen_files.open(md, "w") as f:
-        f.write(Path(md).read_text())
+    try:
+        with mkdocs_gen_files.open(md, "w") as f:
+            f.write(Path(md).read_text(encoding='utf-8', errors='replace'))
+    except UnicodeDecodeError:
+        # Skip files that can't be decoded as UTF-8
+        print(f"Warning: Skipping {md} due to encoding issues")
+        continue