feat(.github): Add GitHub workflows from hve-core by WilliamBerryiii · Pull Request #22 · Azure-Samples/azure-nvidia-robotics-reference-architecture

WilliamBerryiii · 2025-12-04T20:51:46Z

Pull Request

Description

Add GitHub workflows and linting infrastructure from HVE-Core, with comprehensive markdown lint fixes across the repository.

Type of Change

✨ New feature (non-breaking change adding functionality)
📚 Documentation update

Changes

Workflows Added

markdown-lint.yml - Markdown linting with markdownlint-cli2
link-lang-check.yml - Link validation and language path checking

Linting Infrastructure

Added package.json with markdownlint-cli2, markdown-table-formatter dependencies
Added .markdownlint.jsonc configuration
Added scripts/linting/Link-Lang-Check.ps1 for URL language path validation
Added scripts/linting/Invoke-LinkLanguageCheck.ps1 wrapper script

Documentation Fixes

Fixed 332+ markdownlint errors across 24 files
Formatted all markdown tables for alignment (MD060)
Added blank lines around headings, code fences, and lists (MD031, MD032)
Added language specifiers to fenced code blocks (MD040)
Fixed heading hierarchy issues (MD024, MD025, MD041)
Used 4-backtick wrappers for nested code block templates in prompt files
Removed en-us language path segments from Microsoft Docs URLs
Fixed broken relative links in issue/PR templates and documentation

Component(s) Affected

.github/ - Workflows, templates, and instructions
deploy/ - README documentation
docs/ - Technical documentation
scripts/ - Linting scripts
workflows/ - Workflow documentation

Checklist

Commit messages follow conventional commit format
Documentation updated as needed
No new linting warnings introduced
All markdown lint checks pass locally

github-actions · 2025-12-04T20:52:02Z

Dependency Review

The following issues were found:

✅ 0 vulnerable package(s)
✅ 0 package(s) with incompatible licenses
✅ 0 package(s) with invalid SPDX license definitions
✅ 0 package(s) with unknown licenses.
⚠️ 24 packages with OpenSSF Scorecard issues.

View full job summary

Copilot

Pull request overview

This PR introduces a comprehensive CI/CD linting infrastructure by porting GitHub Actions workflows and PowerShell linting scripts from microsoft/hve-core. The implementation provides automated quality checks for markdown, PowerShell, links, spelling, and dependencies across pull requests and the main branch.

Key Changes

10 GitHub Actions workflows orchestrating linting checks with reusable workflow patterns and security hardening
5 PowerShell linting scripts with git-aware file targeting and GitHub Actions integration
npm-based tooling for spell checking, markdown linting, and link validation

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
`.github/workflows/pr-validation.yml`	Orchestrates all linting checks for PRs to main branch
`.github/workflows/main.yml`	Runs CI checks on pushes to main branch
`.github/workflows/spell-check.yml`	Reusable workflow for cspell spell checking
`.github/workflows/markdown-lint.yml`	Reusable workflow for markdownlint-cli2 linting
`.github/workflows/table-format.yml`	Reusable workflow for markdown table formatting
`.github/workflows/ps-script-analyzer.yml`	Reusable workflow for PowerShell script analysis
`.github/workflows/link-lang-check.yml`	Reusable workflow for URL locale path detection
`.github/workflows/markdown-link-check.yml`	Reusable workflow for broken link detection
`.github/workflows/dependency-review.yml`	Security scanning for dependency vulnerabilities
`.github/workflows/codeql-analysis.yml`	Weekly CodeQL security analysis for Python
`scripts/linting/Modules/LintingHelpers.psm1`	Shared PowerShell helper functions for git operations and GitHub Actions integration
`scripts/linting/Invoke-PSScriptAnalyzer.ps1`	Wrapper script for PSScriptAnalyzer with changed-files-only support
`scripts/linting/Markdown-Link-Check.ps1`	Git-aware markdown link validator with XML result parsing
`scripts/linting/Link-Lang-Check.ps1`	Detector and fixer for locale-specific URL paths
`scripts/linting/Invoke-LinkLanguageCheck.ps1`	GitHub Actions wrapper for Link-Lang-Check.ps1
`scripts/linting/PSScriptAnalyzer.psd1`	PSScriptAnalyzer configuration with project-specific rule exclusions
`scripts/linting/markdown-link-check.config.json`	Configuration for markdown-link-check tool
`package.json`	npm dependencies and scripts for linting tools
`.markdownlint-cli2.jsonc`	Markdownlint-cli2 configuration replacing .markdownlint.json

.github/workflows/link-lang-check.yml

.github/workflows/pr-validation.yml

.github/workflows/link-lang-check.yml

.github/workflows/dependency-review.yml

package.json

.github/workflows/codeql-analysis.yml

.github/workflows/dependency-review.yml

.github/workflows/pr-validation.yml

- link-lang-check: remove unused SoftFail param splatting - link-lang-check: correct env var LINK_LANG_CHECK_FAILED to LINK_LANG_FAILED - pr-validation: add pull-requests: write for dependency-review job - dependency-review: remove duplicate pull_request trigger, add harden-runner - package.json: use exact versions (remove ^ prefix) - codeql-analysis: clarify time format to 04:00 UTC 🔧 - Generated by Copilot

- add package.json with lint:md, lint:ps, lint:links, spell-check scripts - migrate .markdownlint.json to .markdownlint-cli2.jsonc with ignores - add PowerShell linting scripts from hve-core pattern - add LintingHelpers module for GitHub Actions integration 🔧 - Generated by Copilot

- add pr-validation.yml orchestrating linting on pull requests - add main.yml for CI on pushes to main branch - add codeql-analysis.yml for Python security scanning - add dependency-review.yml for PR dependency security checks - add individual reusable workflows: spell-check, markdown-lint, table-format, ps-script-analyzer, link-lang-check, markdown-link-check - add Markdown-Link-Check.ps1 script and config 🔧 - Generated by Copilot

- link-lang-check: remove unused SoftFail param splatting - link-lang-check: correct env var LINK_LANG_CHECK_FAILED to LINK_LANG_FAILED - pr-validation: add pull-requests: write for dependency-review job - dependency-review: remove duplicate pull_request trigger, add harden-runner - package.json: use exact versions (remove ^ prefix) - codeql-analysis: clarify time format to 04:00 UTC 🔧 - Generated by Copilot

📦 - Generated by Copilot

- add changed-files detection step to markdown-lint workflow - add changed-files detection step to markdown-link-check workflow - skip lint/link-check when no markdown files changed 📦 - Generated by Copilot

- auto-fix blanks-around-lists and blanks-around-fences violations - add LICENSE.md and ISSUE_TEMPLATE.md to lint ignores - fix line length and emphasis-as-heading in README - update Azure CLI URL to learn.microsoft.com 📝 - Generated by Copilot # Conflicts: # .github/ISSUE_TEMPLATE.md # README.md

🔗 - Generated by Copilot

📄 - Generated by Copilot

- Update README.md link to point to LICENSE instead of LICENSE.md - Remove LICENSE.md from markdownlint ignores 📝 - Generated by Copilot

- Fix 332 markdownlint errors across 24 files (tables, headings, code blocks) - Revert workflows to lint all files instead of using changed-files filter - Use 4-backtick wrapper in chatlog.prompt.md for nested code block template - Restore SECURITY.md Microsoft boilerplate content 📝 - Generated by Copilot

- Remove en-us from 4 URLs in vpn/README.md and azureml-validation-job-debugging.md - Reformat tables after URL changes 🔗 - Generated by Copilot

- Fix issue template: README.md → ../../README.md, docs/ → ../../docs/ - Fix PR template: remove .github/ prefix from relative paths - Fix debugging doc: update deploy/004-workflow path to workflows/azureml 🔗 - Generated by Copilot

Copilot AI review requested due to automatic review settings December 4, 2025 20:51

Copilot started reviewing on behalf of WilliamBerryiii December 4, 2025 20:52 View session

Copilot finished reviewing on behalf of WilliamBerryiii December 4, 2025 20:55

Copilot AI reviewed Dec 4, 2025

View reviewed changes

agreaves-ms approved these changes Dec 11, 2025

View reviewed changes

WilliamBerryiii mentioned this pull request Jan 31, 2026

refactor(scripts): Consolidate common functions into shared lib #50

Closed

7 tasks

WilliamBerryiii added 6 commits January 30, 2026 21:28

fix: add package-lock.json for npm caching in CI workflows

08ca896

📦 - Generated by Copilot

fix(build): lint only changed markdown files in PRs

e6a4b28

- add changed-files detection step to markdown-lint workflow - add changed-files detection step to markdown-link-check workflow - skip lint/link-check when no markdown files changed 📦 - Generated by Copilot

WilliamBerryiii force-pushed the feature/github-workflows branch from 606f0f7 to 8cb3a84 Compare January 31, 2026 06:30

WilliamBerryiii added 6 commits January 30, 2026 22:41

fix(docs): correct broken link to OSMO workflow examples

7c37089

🔗 - Generated by Copilot

chore(docs): rename LICENSE.md to LICENSE

609708e

📄 - Generated by Copilot

docs: update LICENSE references after rename

1fbfca2

- Update README.md link to point to LICENSE instead of LICENSE.md - Remove LICENSE.md from markdownlint ignores 📝 - Generated by Copilot

fix(docs): remove en-us path segment from Microsoft Docs URLs

d95e4ab

- Remove en-us from 4 URLs in vpn/README.md and azureml-validation-job-debugging.md - Reformat tables after URL changes 🔗 - Generated by Copilot

agreaves-ms approved these changes Feb 2, 2026

View reviewed changes

WilliamBerryiii merged commit 96ae111 into main Feb 2, 2026
8 checks passed

WilliamBerryiii deleted the feature/github-workflows branch February 2, 2026 23:47

This was referenced Feb 7, 2026

chore(main): release 1.0.0 #140

Closed

chore(main): release 0.1.0 #143

Merged

chore(main): release 0.2.0 #144

Closed

chore(main): release 0.3.0 #173

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(.github): Add GitHub workflows from hve-core#22

feat(.github): Add GitHub workflows from hve-core#22
WilliamBerryiii merged 12 commits intomainfrom
feature/github-workflows

WilliamBerryiii commented Dec 4, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Dec 4, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

WilliamBerryiii commented Dec 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pull Request

Description

Type of Change

Changes

Workflows Added

Linting Infrastructure

Documentation Fixes

Component(s) Affected

Checklist

Uh oh!

github-actions bot commented Dec 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Dependency Review

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Key Changes

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

WilliamBerryiii commented Dec 4, 2025 •

edited

Loading

github-actions bot commented Dec 4, 2025 •

edited

Loading