Skip to content

[INFRA] Establish unified project-wide standards (issue #14)#4

Merged
kristopherjturner merged 5 commits into
mainfrom
feature/issue-14-unified-standards
Mar 17, 2026
Merged

[INFRA] Establish unified project-wide standards (issue #14)#4
kristopherjturner merged 5 commits into
mainfrom
feature/issue-14-unified-standards

Conversation

@kristopherjturner
Copy link
Copy Markdown
Contributor

Summary

Implements unified project-wide standards for the VM conversion toolkit repo, per AzureLocal/azurelocal.github.io#14.

Changes

  • Update CONTRIBUTING.md with links to central standards at azurelocal.cloud/standards
  • Add Standards Compliance checklist to PR template
  • *Add \�alidate-repo-structure.yml* CI workflow

Links

…#15)

- Create config/ directory with variables.example.yml
- Documents common parameters needed across all conversion scripts
- Uses org standard snake_case naming and IIC placeholder values
- Add config/variables.yml to .gitignore

Resolves AzureLocal/azurelocal.github.io#15
Add config/schema/variables.schema.json for validating variables.example.yml.
Add CI workflow that validates example config against schema on PR.

Part of AzureLocal/azurelocal.github.io#15
- Create docs/reference/ directory and variables.md
- Full sectioned reference matching config/variables.example.yml
- Sections: azure, azure_local, conversion, tags
- Add naming rules table and script parameter mapping
- Add Reference nav section in mkdocs.yml

Part of: AzureLocal/azurelocal.github.io#15
- Update CONTRIBUTING.md with links to central standards
- Add standards compliance checklist to PR template
- Add validate-repo-structure CI workflow
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces org-wide standards alignment for the VM conversion toolkit repo by linking to centralized AzureLocal standards, adding a standards compliance checklist to the PR template, and enforcing required repo layout via CI.

Changes:

  • Add a “Standards” section to CONTRIBUTING.md with links to AzureLocal’s central standards pages.
  • Extend the PR template with a “Standards Compliance” checklist.
  • Add a CI workflow to validate required repository files/directories and (optionally) config/documentation structure.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
CONTRIBUTING.md Adds a “Standards” section linking to org-wide standards documentation.
.github/workflows/validate-repo-structure.yml New CI workflow to validate repo structure and required artifacts.
.github/pull_request_template.md Adds a Standards Compliance checklist section to the PR template.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

Comment on lines +44 to +45
if [ ! -f ".github/PULL_REQUEST_TEMPLATE.md" ]; then
echo "::error::Missing .github/PULL_REQUEST_TEMPLATE.md"

jobs:
check-structure:
runs-on: ubuntu-latest
@kristopherjturner kristopherjturner merged commit dd3cb21 into main Mar 17, 2026
1 of 2 checks passed
@kristopherjturner kristopherjturner deleted the feature/issue-14-unified-standards branch March 17, 2026 16:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority/high Next sprint solution/vmconvert VM conversion toolkit type/infra CI/CD, workflows, repo config

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants