Repository navigation
Description
Describe the change
Context and request
Reporters need specific instructions that explain what information each shared issue form collects. Replace conversational filler and vague requests in the bug, patch, and general forms with direct en-US instructions. This delivery leaf covers one prose-only draft PR.
Evidence and sources
At source 0c67251812ea306543f3a14ab473ae357cfb76ac, .github/ISSUE_TEMPLATE/01-bug.yml:12-13, 02-patch.yml:12-13, and 99-general.yml:12-13 ask for “as much information as possible” and promise that “we can help you quickly.” The patch description at line 19 says “what you would want to change.” These statements add no verifiable input requirement.
The fixed Natural Language standard requires direct, specific en-US prose and removes words that do not change meaning. The Writing Guide preserves interface contracts and each artifact's format. The official STEMG FAQ explains direct imperative procedures and controlled technical terms. Consult Issue 9 for exact rules or dictionary details; an automated scan does not establish full STE conformance.
Acceptance criteria
- Each introduction names the information the form collects without thanks, politeness filler, an unlimited-information request, or a response-speed promise.
- Field prompts state concrete requested information in direct instructions. The bug form retains its expected/actual behavior, environment, reproduction, relevant-details, and supporting-evidence intent.
- Every existing YAML key, field ID, field order, field type, required flag, form name/title, label, and routing value remains unchanged. Only reader-facing prose changes.
- The diff contains only the three owned forms.
.github/ISSUE_TEMPLATE/10-feature.yml,config.yml, tests, and validation tooling remain outside this PR. - The issue and PR retain before/after evidence and exact validation commands with results. The PR remains in draft; no merge or Agent merge change occurs.
Technical decisions
Owned paths are .github/ISSUE_TEMPLATE/01-bug.yml, .github/ISSUE_TEMPLATE/02-patch.yml, and .github/ISSUE_TEMPLATE/99-general.yml. Preserve the GitHub issue-form format rather than applying a durable spec/design template. Reuse an already installed YAML parser to compare non-prose structure before and after the edit. The repository base has no validation scripts or lint configuration; unmerged #12 is not installed or enforced. Do not add a linter, dependency, test framework, policy, form field, or repository audit file for this change. #15 owns the feature form and its tests.
Implementation plan
- Read the owned forms and applicable pinned standards; capture a baseline structural comparison and concrete prose acceptance checks before editing.
- Make surgical prose changes, keep one logical change per small commit, and open the scoped draft PR early.
- Compare every non-prose YAML value and structure with the baseline; review the requested-information meaning and technical terms.
- Run the existing applicable checks,
git diff --check, and the focused structural comparison; record each command and result without claiming full STE conformance. - Review the final diff, update this plan with evidence, link only the delivery work it resolves, and leave the PR in draft.
Delivery progress
Draft MSXOrg/.github#21 opened after the first bug-form commit, e3e59ac00134eaec301506e2f01492d90faead9b. The second commit, deb2e80d65c1334a140c2f8c15eae738329542fb, completes the patch and general forms. Both commits are pushed, and the working tree is clean. The current-head Copilot review is APPROVED with no inline comments and no review threads. The original delivery handoff left the PR in draft with GitHub auto-merge off and no Agent merge change. The later user-directed lifecycle and fresh preparation are recorded below.
Verification evidence
The baseline snapshot contains the complete parsed YAML for all three forms at 0c67251812ea306543f3a14ab473ae357cfb76ac. The comparison preserves mapping-key and field order, node types, scalar tags and styles, and every non-prose value. Only the three introduction strings and seven field-description strings can differ.
The focused check and snapshot remain in the implementation session's local artifacts. They are not repository scripts or CI enforcement. PowerShell commands use this local script:
$check = "$env:USERPROFILE\.copilot\session-state\73d907e5-c9b5-46c2-ab63-6404c149f36f\files\check_intake_forms.py"| Command | Baseline result | Candidate result |
|---|---|---|
python $check structure |
Passed: all three complete non-prose contracts match; no changed repository files. | The same full comparison passes as part of python $check all. Only the three owned forms differ. |
python $check prose |
Expected failure: 3 of 10 prose values pass and 7 fail. All three introductions, the bug description and environment prompt, and the patch and general descriptions fail. | All 10 prose values pass as part of python $check all. |
python $check all --forms bug |
Not run before the edit; the complete baseline checks above cover it. | Passed before the first commit: three complete contracts match and all six bug-form prose values pass. |
python $check all |
Not run as one command; the structure and prose checks above ran separately. | Passed: three complete contracts match, all 10 prose values pass, and the changed-file set contains exactly the three owned forms. |
python -m yamllint --strict .github\ISSUE_TEMPLATE\01-bug.yml .github\ISSUE_TEMPLATE\02-patch.yml .github\ISSUE_TEMPLATE\99-general.yml |
Passed, exit 0. | Passed, exit 0, with already installed yamllint 1.38.0. No dependency was added. |
git diff --check |
Not run before the edit. | Passed, exit 0. |
git diff 0c67251812ea306543f3a14ab473ae357cfb76ac --check |
Not run before the edit. | Passed, exit 0, across the complete delivery diff. |
git diff 0c67251812ea306543f3a14ab473ae357cfb76ac HEAD --check |
Not run before the edit. | Passed, exit 0, after both commits were pushed. |
git diff --cached --check |
Not run before the edit. | Passed before each small commit, exit 0. |
The source review covers the pinned Documentation Model, Natural Language, Writing Guide, Markdown, Documentation, YAML, and applicable issue and delivery-process guidance. The official STE overview and FAQ are accessible. The local Issue 9 PDF has MD5 9c720341c350ed77943b2c73d01c716f; the review uses its procedural-writing rules and relevant dictionary entries without republishing the manual or claiming full STE conformance.
The local parser is PyYAML 6.0.3. The wording checks are one-time delivery evidence, not a maintained phrase-freezing test suite. No repository test or validation file is added.
Before and after
| Surface | Baseline wording | Candidate wording |
|---|---|---|
| Bug introduction | Thanks for taking the time to fill out this bug report! Please provide as much information as possible so we can help you quickly. | This form records the expected and actual behavior, environment, steps to reproduce the problem, related information, and evidence. |
| Patch introduction | Thanks for taking the time to fill out this form! Please provide as much information as possible so we can help you quickly. | This form records the change you want to existing content or behavior. |
| General introduction | Thanks for taking the time to fill out this form! Please provide as much information as possible so we can help you quickly. | This form records the subject and related information for an issue that does not fit the other forms. |
| Bug description | A clear and concise description of what the bug is vs. what you expected to happen. | Give the expected behavior and the actual behavior. |
| Bug environment | What version, commit, platform, or configuration were you using when the problem occurred? | Give the version, commit, platform, or configuration in use when the problem occurred. |
| Patch description | A clear and concise description of what you would want to change. | Give the existing content or behavior and the change you want. |
| General description | A clear and concise description. | Give the subject of the issue and the related information. |
Manual review confirms that the bug form still asks for the same reproduction steps, commands, inputs, or conditions; related code, configuration, logs, screenshots, links, or context; and error messages or other evidence. The wording uses direct Give and Include instructions. The environment prompt retains or; it does not require every listed environment value.
No-change evidence
The parsed comparison also protects the existing top-level descriptions, all names and titles, labels, IDs, field order, types, and required flags. The bug form retains three required and two optional textareas; the patch and general forms each retain one required textarea. No input, routing rule, or submission requirement changes.
The feature form, config.yml, tests, validation tooling, README, contribution guidance, PR template, agent instructions, profile, security, and support files remain unchanged. The native form format owns these prompts; no spec/design template or capability scaffolding is needed. The repository's fallback role and central-standards link remain correct and need no edit for this prose-only slice.
The scoped convergence command gh issue list --repo MSXOrg/.github --state open --search 'in:body ISSUE_TEMPLATE' --limit 50 --json number,title,body,url returns this Task and #14. The latter owns the feature form and is not satisfied by this diff. No additional issue receives a closing reference.
Original review and readiness (2026-11-04)
The final standards pass covers all three changed forms against fixed MSXOrg/docs commit 1b0d4893c8fefabe604d04393068a8ff6f848082 and the native GitHub issue-form format. The native form format, requested information, and en-US prose remain consistent. All required source material is accessible; there is no source or access blocker.
At candidate deb2e80d65c1334a140c2f8c15eae738329542fb, gh api repos/MSXOrg/.github/commits/deb2e80d65c1334a140c2f8c15eae738329542fb/check-runs --jq '{total_count,check_runs:[.check_runs[] | {name,status,conclusion,head_sha,html_url}]}' reports one completed successful copilot-pull-request-reviewer check. The commit-status API reports zero statuses. There is no repository-validation check at this head; the review check is not a substitute for one.
Hosted validation remains separate work in open #12. Its scripts and configuration are not part of this source baseline or this PR. The hosted-validation readiness gate remains open, not passed. This Task stays open until its PR is merged, and the PR stays draft as requested.
Fresh preparation (2026-11-11)
The fresh exact-head evidence verifies unchanged head deb2e80d65c1334a140c2f8c15eae738329542fb against live base and merge base 0c67251812ea306543f3a14ab473ae357cfb76ac. The unmodified pinned shared-validator default matches the published blob and shipped yamllint 1.38.0 pin. All 12 normal/strict baseline-versus-candidate runs pass with zero diagnostics; six additional explicit-installed-default strict runs also pass. All 3 non-prose contracts match across 28 mappings, 6 sequences, and 122 scalars, with only 10 prose values changed. All 7 textarea contracts, including 5 required and 2 optional fields, remain intact.
The real GitHub Markdown API returns HTTP 200 for all 6 baseline/candidate introduction renders, with complete visible text. Link verification is inapplicable because all 48 scalar string values and the native output contain zero targets. Fresh whitespace and exact three-file scope checks pass. No source, dependency, tooling, rule, label, scheduler, or merge-setting change is made.
The later user instruction supersedes the earlier draft-only constraint: the PR is open and non-draft. The existing current-head approval remains, and fully paginated review inspection finds zero threads or inline comments. Effective inherited ruleset 19735160 still requires code-owner/last-push approval and thread resolution; the classic protection 404 does not remove it. Native APPROVED/MERGEABLE/CLEAN metadata does not establish an independently eligible last-push approval. There is no hosted repository-validation result; the historical review check is not CI evidence. The linked fresh record contains the exact commands, counts, configuration provenance, and protection facts.
GitHub auto-merge is null; Agent merge readback is enabled with merge_pr=false. The exclusive global merge slot remains with the root coordinator. No merge is attempted. This Task remains open, and no content decision or source/access blocker remains for the preparation.
Activity
MariusStorhaug commentedon Nov 4, 2026
The baseline verification is complete. All three full non-prose YAML contracts match source 0c67251. The pre-edit prose checks report 7 failures across 10 values; the installed YAML linter passes. The body records the commands, source review, and local evidence location. The remaining work is the scoped wording change and draft PR.
MariusStorhaug commentedon Nov 4, 2026
The three-form wording change is pushed in two small commits. The draft opened after the first commit. At deb2e80, all 10 prose checks pass, every complete non-prose YAML contract matches the baseline, strict YAML lint passes, and both working-diff and baseline-to-candidate whitespace checks pass. The body records exact before/after wording, commands, unchanged areas, and the scoped issue-convergence result. The current-head review and hosted-check evidence remain pending; the PR stays draft.
MariusStorhaug commentedon Nov 4, 2026
The final delivery record is complete at deb2e80. The PR body covers all three forms, both commits, exact before/after evidence and validation results, the standards pass, and the scoped convergence check. The current-head Copilot review is APPROVED with no inline comments and zero threads. Only the reviewer check is present; hosted repository validation remains an open gate tracked separately in #12. All five plan steps are recorded as complete, but this Task stays open and the PR stays draft, with no merge automation.
MariusStorhaug commentedon Nov 11, 2026
Campaign merge hold (2026-11-11): the user explicitly selected "Hold the six merges until validation is available (Recommended)". The current default branch has no authored validation workflow and this PR has no actual validation checks; manual prose/interface inspection is not counted as CI. Hold #21 until actual validation is available or a new explicit owner decision changes this hold. This is not authorization to add tooling, change rules, waive checks, or revive withdrawn validation work. Prepared source and existing PR/Agent-merge settings stay unchanged.
MariusStorhaug commentedon Nov 11, 2026
Exact-head preparation (2026-11-11)
The accepted three-form content is unchanged at head
deb2e80d65c1334a140c2f8c15eae738329542fb. The livemainbase and merge base are both0c67251812ea306543f3a14ab473ae357cfb76ac. Remote refs match these identities. The worktree is clean; no source, dependency, test, workflow, label, ruleset, scheduler, or merge setting changed.Lint provenance. This repository has no YAML lint configuration or installed hosted validation. Both the campaign-pinned MSX docs source
1b0d4893c8fefabe604d04393068a8ff6f848082and current sourcef9b335d0b78a3eead0b7efa573936e86cb1e7265use the same Docs workflow blob,de01a42b4c230de8b2c7540089cc15b945529a5b, with super-linter4ce20838b8ab83717e78138c5b3a1407148e0918and no YAML override. The pinned shared-validator default, blob2aa49bd1867e24acdea4172191922df6135b69c6, is saved as unmodified bytes outside source. Its dependency pin, blob7ce0eabce1e3283119086a7ae179f2373fc00e13, isyamllint==1.38.0, matching the installed version. These are local validation references, not this repository's CI configuration. The installed default also matches the verified upstream default, blobb082e228469dd5909a6f58dd2466882e16d4ea87.The exact linter commands below run against stdin for each of the three base blobs and each corresponding candidate file. Input bytes come from
git showat the recorded base or the checked-out candidate; the candidate matches the committed head.git diff --checkgit diff 0c67251812ea306543f3a14ab473ae357cfb76ac...deb2e80d65c1334a140c2f8c15eae738329542fb --checkgit diff --name-only 0c67251812ea306543f3a14ab473ae357cfb76ac...deb2e80d65c1334a140c2f8c15eae738329542fb01-bug.yml,02-patch.yml, and99-general.yml, all under.github/ISSUE_TEMPLATE.Native rendering and content.
gh api --include --method POST markdown -H 'Accept: text/html' --input -uses the real GitHub renderer with JSONmode: gfm,context: MSXOrg/.github, and each parsed introduction astext. All 6 requests, covering the 3 baseline and 3 candidate introductions, return HTTP 200. Each renders as one paragraph with complete visible text. The candidate bug and general introductions each retain one literal line break as<br>; the patch introduction has none. This is native Markdown rendering, not a simulated issue form or an issue-submission test.All 48 scalar string values across the three candidate forms contain zero link targets. The native output also contains zero links or images. Link verification is therefore inapplicable, not a passing empty link scan. Manual review of all 3 forms, 10 changed prose values, and the full diff confirms the accepted requested-information meaning, direct instructions, en-US wording, unchanged optionality, and the environment prompt's
or. No content decision or full STE-conformance claim is introduced.Reviews and protections. The current-head Copilot review remains
APPROVED. Fully paginated inspection reports zero inline comments, zero review threads, and no new PR comments. GitHub reportsAPPROVED,MERGEABLE, andCLEAN.gh pr checksreports no checks; the exact-head REST check-run endpoint retains one successful historical review check and zero commit statuses. There is no hosted repository-validation result, and the review check is not one.The effective branch-rules endpoint and inherited active ruleset
19735160require squash-only PRs, stale-review dismissal, code-owner review, last-push approval, extra approval for unattributed changes, and resolved review threads. No required-status-check rule is present. The classic protection endpoint's HTTP 404 does not remove these rules. NoCODEOWNERSfile exists at any supported location in the actual base. The only approving account is Copilot; its collaborator-permission response isnone. Native readiness metadata is recorded, not used as proof of an independently eligible last-push approval or as permission to bypass protection.The PR is open and non-draft under the later user-directed lifecycle change. GitHub auto-merge is null. Agent merge readback is enabled with
merge_pr=false. The exclusive global merge slot remains with the root coordinator. No merge is attempted. Missing hosted CI remains disclosed; operational acceptance of exact-head local evidence does not install CI or waive an actual failing check.The configuration copies, full diagnostics, ordered-tree comparison, and native HTML responses remain in this session's local artifacts. No source or access blocker and no content decision remain for this preparation.
Feature requests start with consumer needs (#15)
MSX entry points provide factual context (#20)
MariusStorhaug commentedon Nov 11, 2026
Completed by the ordinary exact-head guarded squash of #21 on 2026-11-11. Accepted head:
deb2e80d65c1334a140c2f8c15eae738329542fb; squash/final main:7f1748d5ea493521e2307964a51699e611317371; actual prior main:c90c09d7b501edbe919cef222f7cc1ce6004b810. Native exact-head approval, zero fully paginated threads, prerequisites, and effective protections were read before merge. No admin, force, bypass, alternate approval, or settings change was used. Fresh YAML/native-render/interface evidence was operationally accepted; hosted source-validation CI remains absent, not passed. Post-merge full-tree verification proves that this unit changes only the three accepted bug/patch/general form blobs. A second full-tree comparison from original main proves that final main contains exactly all five accepted PR deltas: nine accepted surviving file blobs, the PR-template deletion, and all 33 other original files unchanged. Zero recognized root/.github/docs PR templates and no added feature snapshot suite remain. All earlier accepted content and untouched reporting/agent-wrapper interfaces are preserved. Actual main integration, this delivery-leaf closure, and absence of the exact remote topic branch are verified. No live form submission, Pages, package, or fleet rollout result is invented.