Update PDF template for version and date metadata

[Copilot]

Pull Request

Description

Aligns PDF generation with TestResults and SarifMark repository implementations. PDFs now display version and date metadata in headers.

Template changes (docs/template/template.html):

• Split @page @top-center into @top-left (title) and @top-right (version)
• Added .version CSS class and string-set rule
• Changed pre block overflow-x to overflow for better PDF rendering

Workflow changes (.github/workflows/build.yaml):

• Added --metadata version and --metadata date parameters to all pandoc invocations
• Kept default PowerShell shell (matching SarifMark implementation)
• Retained mermaid-filter.cmd extension for Windows compatibility

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Code quality improvement

Related Issues

Implements feature request for updated PDF template based on TestResults repository.

Pre-Submission Checklist

Before submitting this pull request, ensure you have completed the following:

Build and Test

• Code builds successfully: dotnet build --configuration Release
• All tests pass: dotnet test --configuration Release
• Code produces zero warnings

Code Quality

• Code formatting is correct: dotnet format --verify-no-changes
• New code has appropriate XML documentation comments
• Static analyzer warnings have been addressed

Quality Checks

Please run the following checks before submitting:

• Spell checker passes: cspell "**/*.{md,cs}"
• Markdown linter passes: markdownlint "**/*.md"
• YAML linter passes: yamllint '**/*.{yml,yaml}'

Testing

• Added unit tests for new functionality
• Updated existing tests if behavior changed
• All tests follow the AAA (Arrange, Act, Assert) pattern
• Test coverage is maintained or improved

Documentation

• Updated README.md (if applicable)
• Updated ARCHITECTURE.md (if applicable)
• Added code examples for new features (if applicable)
• Updated requirements.yaml (if applicable)

Additional Notes

Added docversion to .cspell.json dictionary. Workflow aligned with SarifMark implementation for proper filter execution on Windows. No functional changes to code - workflow and template only.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Feature]: Updated PDF template</issue_title>
<issue_description>### Problem Statement

The Pandoc template for PDFs should be updated

Proposed Solution

Review https://github.com/demaconsulting/TestResults and:

• Update the pandoc template in /docs/template
• Update the build-docs job to:
  • Replace pwsh with bash shell
  • Pass version and date metadata parameters to pandoc

Alternatives Considered

No response

Usage Examples

Benefits

Improved document quality

Priority

Low - Nice to have

Willingness to Contribute

Yes, I can submit a pull request

Additional Context

No response

Checklist

• I have searched existing issues to ensure this is not a duplicate
• I have provided a clear description of the feature
• I have explained why this feature would be useful</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes [Feature]: Updated PDF template #70

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[Malcolmnixon]

@copilot The build-docs job failed - I believe because the mermaid-filter command was not specified correctly. Please closely compare the job with https://github.com/demaconsulting/SarifMark and align how commands are executed.

[Copilot]

@copilot The build-docs job failed - I believe because the mermaid-filter command was not specified correctly. Please closely compare the job with https://github.com/demaconsulting/SarifMark and align...

Fixed in commit 1dd5797. The issue was using shell: bash with mermaid-filter - removed the bash shell specification and restored the .cmd extension to match SarifMark's implementation. The pandoc steps now use the default PowerShell shell on Windows with the correct filter path.