Improve documentation of VCS scripts

Some of the documentation was based on an old version of the code.

Author: dhebbeker

generate_vcs_identifier.py

@@ -5,9 +5,6 @@
 identifier string. It retrieves the VCS identifier from the 'vcs_utils' module
 and writes it to a specified source file.
 
-The script will overwrite the file if it already exists, and any write failures 
-are handled gracefully.
-
 This script should be loaded by PlatformIO during the project build and is not
 designed to be run independently.
 """

vcs_utils.py

@@ -2,7 +2,7 @@
 vcs_utils.py
 
 This module provides utility functions to retrieve the version control system
-(VCS) identifier using Git and to write it to a C source file.
+(VCS) identifier using Git and to write it to a file.
 
 The functions handle cases where Git is not installed or the current directory
 is not a Git repository, and handle file write failures gracefully.
@@ -43,11 +43,11 @@ def get_vcs_id():
 
 def write_vcs_id_to_file(vcs_id, file_path):
     """
-    Writes the given VCS identifier as a C-style string to a file.
+    Defines a macro with the given VCS identifier as a string literal to a file.
     
     Args:
         vcs_id (str): The VCS identifier string to write to the file.
-        file_path (str): The path to the C source file to write to.
+        file_path (str): The path to the file to write to.
     
     If the file exists, it will be overwritten. If writing to the file fails,
     a warning will be printed to stderr, but the script will not terminate