Fix: Correct docs generation and GitHub workflow

This commit addresses several issues in the documentation generation process:

1.  **`docs/scripts/generate_site_data.py`:**
    *   Modified to scan actual root-level language directories (e.g., C, Python) instead of a non-existent `code_examples/` directory.
    *   Updated to fetch Git commit history from the entire repository, providing a more accurate "Recent Activity" feed.
    *   Removed the unused `code_examples_dir` creation.

2.  **`docs/index.html`:**
    *   Corrected the language details modal to display actual filenames (using `file.name`) instead of `[object Object]`.
    *   Updated to use language icons provided in `site_data.json` directly, removing the local `languageIcons` map.

3.  **`.github/workflows/generate_docs.yml`:**
    *   Adjusted the `paths` trigger to monitor actual language directories (e.g., `C/**`, `Python/**`) for changes, ensuring the workflow runs when relevant code is updated.
    *   Removed the unnecessary `pip install pyyaml` step, as the script uses the standard `json` library.

4.  **`docs/README.md`:**
    *   Updated to accurately describe the new behavior of the `generate_site_data.py` script, including how it scans directories and fetches Git history.

These changes ensure that the documentation website accurately reflects the content of the repository and that the generation process is robust and efficient.

Author: google-labs-jules[bot]

.github/workflows/generate_docs.yml

@@ -5,7 +5,17 @@ on:
     branches:
       - main
     paths:
-      - 'code_examples/**'
+      - 'C/**'
+      - 'C#/**'
+      - 'C++/**'
+      - 'Go/**'
+      - 'Html/**'
+      - 'Java/**'
+      - 'Javascript/**'
+      - 'PHP/**'
+      - 'Python/**'
+      - 'Rust/**'
+      - 'typescript/**'
       - 'docs/scripts/generate_site_data.py'
   schedule:
     - cron: '0 0 * * *'  
@@ -29,7 +39,7 @@ jobs:
           python-version: '3.10'
 
       - name: Install dependencies
-        run: pip install pyyaml
+        run: echo "No Python dependencies to install beyond standard library"
 
       - name: Generate site data
         run: python docs/scripts/generate_site_data.py

docs/README.md

@@ -14,9 +14,9 @@ The website dynamically displays:
 This information is sourced from the `docs/site_data.json` file.
 
 The `docs/site_data.json` file is, in turn, generated by the Python script located at `docs/scripts/generate_site_data.py`. This script now:
-1. Scans the root of the repository to identify language-specific directories.
-2. For each language directory, it scans its top-level contents (files and sub-directories), excluding common build artifacts and hidden files, to gather the detailed file/project list.
-3. Fetches the latest commit history using Git commands.
+1. Scans the root of the repository (e.g., `../../` from its own location) to identify language-specific directories by looking for top-level folders that are not hidden (e.g., not starting with a `.`) and are not common non-code directories like `docs/`, `.git/`, or `.github/`.
+2. For each identified language directory, it recursively scans for files with supported extensions (e.g., `.py`, `.js`, `.java`) to gather information like filename, size, and last modified date.
+3. Fetches the latest commit history using Git commands for the entire repository.
 The script then compiles this information into the `site_data.json` file.
 
 ## Updating the Website Content

docs/index.html

@@ -907,7 +907,7 @@ <h3 class="modal-title" id="modal-title">Language Details</h3>
                     card.className = 'language-card fade-in';
                     card.innerHTML = `
                         <div class="language-header">
-                            <div class="language-icon">${languageIcons[language.name] || language.name.charAt(0)}</div>
+                            <div class="language-icon">${language.icon || language.name.charAt(0)}</div>
                             <h3 class="language-name">${language.name}</h3>
                             <span class="language-count">${language.files.length} examples</span>
                         </div>
@@ -956,7 +956,7 @@ <h3 class="language-name">${language.name}</h3>
                     language.files.forEach(file => {
                         const fileItem = document.createElement('div');
                         fileItem.className = 'file-item';
-                        fileItem.textContent = file;
+                        fileItem.textContent = file.name;
                         fileGrid.appendChild(fileItem);
                     });
 

docs/scripts/generate_site_data.py

@@ -8,7 +8,7 @@
 def get_git_history():
     """Get real Git commit history for recent activity"""
     try:
-        cmd = ['git', 'log', '--pretty=format:%an|%s|%cd', '--date=short', '-n', '5', '--', 'code_examples/']
+        cmd = ['git', 'log', '--pretty=format:%an|%s|%cd', '--date=short', '-n', '5']
         result = subprocess.run(cmd, capture_output=True, text=True)
         activity = []
 
@@ -70,16 +70,21 @@ def get_file_info(root, filename):
         "last_modified": datetime.fromtimestamp(os.path.getmtime(filepath)).strftime('%Y-%m-%d')
     }
 
-def scan_code_examples(code_examples_dir):
-    """Scan the code examples directory and return structured data"""
+def scan_code_examples(base_dir):
+    """Scan the base directory for language directories and return structured data"""
     languages = []
-    
-    for lang_dir in sorted(os.listdir(code_examples_dir)):
-        lang_path = os.path.join(code_examples_dir, lang_dir)
-        if not os.path.isdir(lang_path):
-            continue
-        
-        lang_files = []
+    excluded_dirs = ['.git', 'docs', '.github', 'site_data_files']
+
+    for item_name in sorted(os.listdir(base_dir)):
+        item_path = os.path.join(base_dir, item_name)
+        if os.path.isdir(item_path) and \
+           not item_name.startswith('.') and \
+           item_name not in excluded_dirs:
+            
+            lang_dir = item_name # item_name is now the language directory
+            lang_path = item_path # path to the language directory
+
+            lang_files = []
         supported_extensions = ('.py', '.js', '.java', '.c', '.cpp', '.cs', 
                               '.go', '.rs', '.php', '.html', '.ts', '.sh')
 
@@ -124,12 +129,11 @@ def get_language_icon(lang_name):
 
 def generate_site_data():
     """Generate the complete site data structure"""
-    code_examples_dir = "code_examples"
-    os.makedirs(code_examples_dir, exist_ok=True)
-    
+    base_dir = "../../"  # Point to the repository root
+
     return {
         "last_updated": datetime.now().strftime('%Y-%m-%d %H:%M:%S'),
-        "languages": scan_code_examples(code_examples_dir),
+        "languages": scan_code_examples(base_dir),
         "recent_activity": get_git_history(),
         "stats": {
             "total_languages": 0,  # Will be updated after