Forge and standardize public TSG templates - #342
Open
John Neemes (1008covingtonlane) wants to merge 1 commit into
Open
Forge and standardize public TSG templates#342John Neemes (1008covingtonlane) wants to merge 1 commit into
John Neemes (1008covingtonlane) wants to merge 1 commit into
Conversation
Align all authoring templates with safety, applicability, validation, persona, and automation requirements. Add the canonical public TSG metadata schema and provenance vocabulary. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot started reviewing on behalf of
John Neemes (1008covingtonlane)
August 17, 2026 16:55
View session
John Neemes (1008covingtonlane)
requested review from
Alex Burns (AlBurns-MSFT) and
Adam Rudell (arudell)
August 17, 2026 16:57
Contributor
There was a problem hiding this comment.
Pull request overview
Standardizes Azure Local supportability authoring with safety, validation, applicability, and automation guidance.
Changes:
- Expands article and component templates with consistent authoring prompts.
- Adds the canonical TSG metadata schema.
- Updates contribution and review guidance.
Reviewed changes
Copilot reviewed 11 out of 11 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
TSG/Templates/tsg-metadata.schema.json |
Defines metadata validation. |
TSG/Templates/Troubleshoot-Template.md |
Expands troubleshooting guidance. |
TSG/Templates/Reference-Template.md |
Standardizes reference articles. |
TSG/Templates/Overview-Template.md |
Adds routing and validation guidance. |
TSG/Templates/Markdown-Snippets.md |
Adds reusable authoring patterns. |
TSG/Templates/HowTo-Template.md |
Expands procedural safety guidance. |
TSG/Templates/DeepDive-Template.md |
Adds evidence and operational boundaries. |
TSG/Templates/Component/README-Template.md |
Standardizes component inventories. |
TSG/Templates/Component/CONTRIBUTING-Template.md |
Defines component contribution requirements. |
CONTRIBUTING.md |
Updates repository authoring requirements. |
.github/copilot-instructions.md |
Updates automated review guidance. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| | Product or component | Supported versions | Supported scenarios | Unsupported scenarios | Source of truth | | ||
| | -------------------- | ------------------ | ------------------- | --------------------- | --------------- | | ||
| | {Azure Local product or component} | {Version or build range} | {Where this applies} | {Where this does not apply} | {Public Microsoft Learn URL or product documentation} | | ||
| | {OEM, hardware, driver, firmware, or module when applicable} | {Version or model range} | {Supported use} | {Unsupported use} | {Public Microsoft Learn URL or OEM public documentation when permitted} | |
|
|
||
| | Check | Command | Result | Report path or output | | ||
| | --- | --- | --- | --- | | ||
| | TSG-FORGE lint | `python3 <path-to-tsg-forge>/harness.py --lint --tsg <article-file>` | <A, B, F, or not run> | <report path> | |
Comment on lines
+137
to
+145
| Technical grade records the TSG outcome: | ||
|
|
||
| | Grade | Meaning | | ||
| | --- | --- | | ||
| | `null` | No TSG-FORGE technical grade has been established | | ||
| | A | Detector, discoverability, documented mitigation, and revalidation passed | | ||
| | B | Live loop passed, but documented discoverability is incomplete | | ||
| | C | Recovery required fallback automation or failure detail was not actionable | | ||
| | F | The bad state was not detected or the documented mitigation did not restore service | |
Comment on lines
+128
to
+136
| Technical grade records the TSG outcome, not the cluster outcome: | ||
|
|
||
| | Grade | Meaning | | ||
| | --- | --- | | ||
| | `null` | No TSG-FORGE technical grade has been established | | ||
| | A | The detector, discoverability, documented mitigation, and revalidation passed | | ||
| | B | The live loop passed, but documented discoverability is incomplete | | ||
| | C | Recovery required fallback automation or the failure detail was not actionable | | ||
| | F | The bad state was not detected or the documented mitigation did not restore service | |
Comment on lines
+174
to
+189
| ```powershell | ||
| # Pre-check | ||
| {Pre-check command} | ||
|
|
||
| # Action | ||
| {Mitigation command} | ||
|
|
||
| # Rollback, if the stop condition is met | ||
| {Rollback command} | ||
|
|
||
| # Rollback verification | ||
| {Rollback verification command} | ||
|
|
||
| # Verification | ||
| {Verification command} | ||
| ``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
azure-local-supportability/tsg-metadata/v1JSON Schema.Validation