chore: enhance documentation generation workflow by injecting front matter and verifying HTML output

- Added a step to inject front matter into markdown files that are missing it, ensuring proper Jekyll processing.
- Included a verification step to check for generated HTML files in the features directory, improving build validation.
- Updated logging for better visibility during the documentation generation process.

Author: mokhld

.github/workflows/test-docs-generation.yml

@@ -79,6 +79,14 @@ jobs:
             sed -i 's/\.md/\.html/g' "$file"
           done
           
+          # Inject front matter into all markdown files that are missing it
+          find site-src -name "*.md" | while read file; do
+            if ! grep -q "^---" "$file"; then
+              echo "Injecting front matter into $file"
+              sed -i '1s/^/---\nlayout: default\n---\n\n/' "$file"
+            fi
+          done
+          
           # Create Gemfile with exact dependencies
           cat > site-src/Gemfile << EOF
           source 'https://rubygems.org'
@@ -138,6 +146,10 @@ jobs:
           bundle exec jekyll build --destination ../_site
           cd ..
           
+          # Verify HTML files were generated for features
+          echo "Checking for built HTML pages:"
+          find _site/features -name "*.html" | head -n 10
+          
           # Display final build structure for debugging
           echo "Final site structure:"
           find _site -type f | grep -v ".git" | grep -e "index.html" -e "assets" -e "schema" | head -n 10