Update schema documentation for removed included_file_schema and remove deprecated safe-jobs field #11356
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.
included_file_schema.jsonwas removed but documentation still referenced it across 4 files. Additionally,safe-jobsimplementation details were undocumented, creating confusion about whether it's a user-facing field. The deprecated top-levelSafeJobsfield has been removed from the Go code to align with the schema.Changes
Removed stale schema references:
specs/schema-validation.md- Updated from 3 to 2 schemas, removed go:embed exampleskills/developer/SKILL.md- Removed from schema files table.github/workflows/schema-consistency-checker.md- Removed from analysis files list.github/workflows/schema-consistency-checker.lock.yml- Recompiled to reflect markdown changesClarified safe-jobs implementation:
docs/src/content/docs/reference/safe-outputs.mdexplaining safe-jobs is internal-only, accessed viasafe-outputs.jobs:configurationpkg/workflow/safe_jobs.goas internal implementationRemoved deprecated safe-jobs field:
SafeJobsfield fromFrontmatterConfigstruct inpkg/workflow/frontmatter_types.goToMap()methodsafe-outputs.jobsinstead of deprecatedsafe-jobssyntaxContext
Users configure custom safe output jobs via
safe-outputs.jobs:in frontmatter. The compiler internally processes these as "safe-jobs" (pkg/workflow/safe_jobs.go), but the top-levelsafe-jobs:key is deprecated and rejected by schema validation. The Go code now aligns with the schema by removing the deprecated field, preventing configuration errors and enforcing the correct pattern.Original prompt
💡 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.