docstring added, comments added as per copilot suggestion

Author: Wurschdhaud

extras/bundle_translations/apply_translations.py

@@ -1,11 +1,22 @@
+"""Apply translations from CSV back to pyRevit bundle YAML files.
+
+This script reads a CSV file containing translations (generated by 
+extract_translations.py) and applies them to the corresponding bundle.yaml
+files, updating or creating multilingual field dictionaries.
+
+Configuration:
+    TRANSLATION_CSV: Path to the CSV file containing translations
+    LANGUAGE_KEY: Translation language key to apply (e.g., 'chinese_s')
+    SOURCE_LANG: Source language key (default: 'en_us')
+"""
 import csv
 from pathlib import Path
 from ruamel.yaml import YAML  # pip install ruamel.yaml
 
 # -------- CONFIG --------
-TRANSLATION_CSV = r"C:\temp\translations.csv"
-LANGUAGE_KEY = "chinese_s"
-SOURCE_LANG = "en_us"
+TRANSLATION_CSV = r"C:\temp\translations.csv"  # same path as in other script
+LANGUAGE_KEY = "chinese_s"  # same as in other script
+SOURCE_LANG = "en_us"  # same as in other script
 # ------------------------
 
 yaml = YAML()
@@ -98,7 +109,7 @@ def main():
             with open(yaml_file, "w", encoding="utf-8") as f:
                 yaml.dump(data, f)
 
-            print(f"[Updating] {yaml_file}")
+            print(f"[Processing] {yaml_file}")
 
         except Exception as e:
             print(f"[ERROR] writing {yaml_file}: {e}")

extras/bundle_translations/extract_translations.py

@@ -1,11 +1,23 @@
+"""Extract translation strings from pyRevit bundle YAML files.
+
+This script scans bundle.yaml files for title and tooltip fields,
+extracting English source text and any existing translations to a CSV file
+for easier translation workflow.
+
+Configuration:
+    BASE_DIR: Root directory containing bundle YAML files
+    OUTPUT_CSV: Path where the CSV file will be written
+    LANGUAGE_KEY: Translation language key (e.g., 'chinese_s')
+    SOURCE_LANG: Source language key (default: 'en_us')
+"""
 import os
 from pathlib import Path
 from ruamel.yaml import YAML  # pip install ruamel.yaml
 import csv
 
 # -------- CONFIG --------
-BASE_DIR = r"C:\Program Files\pyRevit-Master\extensions\pyRevitTools.extension"
-OUTPUT_CSV = r"C:\temp\translations.csv"
+BASE_DIR = r"C:\Program Files\pyRevit-Master\extensions\pyRevitTools.extension"  # adjust for custom installation 
+OUTPUT_CSV = r"C:\temp\translations.csv"  # same path as in other script
 LANGUAGE_KEY = "chinese_s"  # translation key to extract/merge
 SOURCE_LANG = "en_us"  # main source language
 # ------------------------