Update READMEs to reflect documentation restructuring

  - Document new --check mode for license_header_validator.py
  - Update directory structure (removed how-to/reference, added models/sdg)
  - Add CI/CD automation details (weekly schedule, license validation)
  - Remove duplicate script entries and outdated information

Author: zephyrie

README.md

@@ -45,31 +45,37 @@ The documentation follows the [Diátaxis framework](https://diataxis.fr/) princi
     - Telesurgery - Remote surgical operation
   - `asset-catalog/` - **Resources**: Pre-built simulation assets and AI models
   - `sensor-simulation/` - **Capabilities**: Physics-based medical sensor emulation
-  - `how-to/` - **Task Guides**: Step-by-step instructions for specific tasks
-  - `reference/` - **Technical Reference**: APIs, setup guides, and specifications
+  - `models/` - **AI Models & Policies**: Pre-trained models and control policies
+  - `sdg/` - **Synthetic Data Generation**: Tools for creating training data
   - `assets/` - Images and static resources
 - `scripts/` - Documentation maintenance tools
   - `sync_readmes.py` - Synchronizes README files from source repositories
   - `readme-sync-config.yml` - Configuration for README synchronization
-  - `sync_readmes.py` - Synchronizes README files and optionally fixes image paths
+  - `license_header_validator.py` - Validates and adds license headers to code files
 - `mkdocs.yml` - MkDocs configuration
 - `.github/workflows/` - GitHub Actions for automated deployment
 
 ## Automated Documentation Workflow
 
 The documentation is automatically built and deployed through GitHub Actions:
 
-1. **On every push to main**, the workflow:
+1. **Automated triggers**:
+   - On every push to main
+   - Weekly on Mondays at 00:00 UTC
+   - Manual workflow dispatch
+
+2. **The workflow**:
    - Clones the three source repositories (i4h-asset-catalog, i4h-sensor-simulation, i4h-workflows)
-   - Runs the sync script to pull README content into the docs structure
+   - Runs the sync script to pull latest README content
+   - Validates all Python/shell files have proper license headers
    - Builds the MkDocs site
    - Deploys to GitHub Pages at https://isaac-for-healthcare.github.io/i4h/
 
-2. **Content synchronization** is configured in `scripts/readme-sync-config.yml`, which maps:
+3. **Content synchronization** is configured in `scripts/readme-sync-config.yml`, which maps:
    - Source README files from the three repositories
    - Target locations in the documentation structure
 
-3. **To update documentation**:
+4. **To update documentation**:
    - Direct edits: Modify files in `docs/` directory
    - Synced content: Update README files in the source repositories
    - Navigation: Edit the `nav` section in `mkdocs.yml`
@@ -110,16 +116,4 @@ mkdocs build --strict
 
 # Verbose output
 mkdocs serve --verbose
-```
-
-### Troubleshooting
-
-- **Missing repositories**: Ensure source repositories are cloned before running sync
-- **Image issues**: Use `python scripts/sync_readmes.py --fix-all-images` for manual image repair
-- **Build errors**: Check for broken links or missing files with `mkdocs build --strict`
-
-## Support
-
-- Documentation site: https://isaac-for-healthcare.github.io/i4h/
-- GitHub repository: https://github.com/isaac-for-healthcare/i4h-docs
-- Issue tracker: https://github.com/isaac-for-healthcare/i4h-docs/issues
+```

scripts/README.md

@@ -18,18 +18,22 @@ Main script for synchronizing README files from source repositories to documenta
   - Optionally scans and fixes broken image references in all markdown files
   - Locates source images in i4h-* repositories and copies them to docs/assets/images/
   - Updates image references to use correct relative paths
-- **Note**: This script runs automatically in CI/CD builds (without --fix-all-images)
+- **Note**: This script runs automatically in CI/CD builds, pulling latest content weekly
 
 ### license_header_validator.py
 Script for validating and adding SPDX license headers to code files.
-- **Usage**: `python scripts/license_header_validator.py`
+- **Usage**: 
+  - `python scripts/license_header_validator.py` - Add missing headers to files
+  - `python scripts/license_header_validator.py --check` - Check mode for CI/CD (fails if headers missing)
 - **Target Files**: Python (.py) and shell (.sh) files only
 - **Config**: Uses `readme-sync-config.yml` to automatically exclude i4h-* repository directories
 - **Purpose**: 
   - Scans repository for Python and shell files missing license headers
   - Adds Apache 2.0 license headers with proper SPDX identifiers
   - Handles shebang lines correctly by placing headers after them
   - Automatically excludes directories from readme-sync-config.yml
+  - In check mode, exits with error code 1 if any files are missing headers
+- **Note**: This script runs automatically in CI/CD builds in check mode
 
 ### readme-sync-config.yml
 Configuration file that maps source README files to documentation pages.