fix: Add UTF-8 encoding to documentation generation for Windows

Specify encoding explicitly in file operations to prevent UnicodeEncodeError
when building docs on Windows systems that default to cp1252 encoding.

Fixes #24360

Signed-off-by: alekramelaheehridoy <alekramelaheehridoy@gmail.com>
Signed-off-by: alekramelaheehridoy <aliqramalaheehridoy@gmail.com>

Author: alhridoy

docs/contributing/windows_development.md

@@ -165,6 +165,7 @@ def on_startup(command: Literal["build", "gh-deploy", "serve"], dirty: bool):
     # Generate documentation for each parser
     for stem, parser in parsers.items():
         doc_path = ARGPARSE_DOC_DIR / f"{stem}.md"
+        # Specify encoding for building on Windows
         with open(doc_path, "w", encoding="utf-8") as f:
             f.write(parser.format_help())
         logger.info("Argparse generated: %s", doc_path.relative_to(ROOT_DIR))

docs/mkdocs/hooks/generate_argparse.py

@@ -106,6 +106,7 @@ def determine_other_files(self) -> list[Path]:
 
     def determine_title(self) -> str:
         if not self.is_code:
+            # Specify encoding for building on Windows
             with open(self.main_file, encoding="utf-8") as f:
                 first_line = f.readline().strip()
             match = re.match(r'^#\s+(?P<title>.+)$', first_line)
@@ -174,6 +175,7 @@ def on_startup(command: Literal["build", "gh-deploy", "serve"], dirty: bool):
         doc_path = EXAMPLE_DOC_DIR / example.category / example_name
         if not doc_path.parent.exists():
             doc_path.parent.mkdir(parents=True)
+        # Specify encoding for building on Windows
         with open(doc_path, "w+", encoding="utf-8") as f:
             f.write(example.generate())
         logger.debug("Example generated: %s", doc_path.relative_to(ROOT_DIR))