Split docs generation pipeline into v1.0 and beta stages#820
Split docs generation pipeline into v1.0 and beta stages#820ramsessanchez wants to merge 5 commits into
Conversation
Each stage now generates, post-processes, pushes, and opens its own PR for its profile. Authentication (Microsoft.Graph.Authentication) is regenerated as part of the v1.0 stage. All generation/post-processing scripts accept a -GraphProfile (v1.0/beta/both) parameter to scope their work. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: e654e00b-3fad-4d5b-8d51-16a0238a08be
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
1 similar comment
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit a9599fe: ✅ Validation status: passed
For more details, please refer to the build report. |
Per-profile stages frequently produce no changes for a given post-processing step. An unconditional 'git commit' returns exit code 1 on an empty diff, which failed the 'Generate permissions table' task. Commit only when there are staged changes, matching the existing guard in UpdateLinks/MsSubserviceUpdate. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: e654e00b-3fad-4d5b-8d51-16a0238a08be
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit a9599fe: ✅ Validation status: passed
For more details, please refer to the build report. |
|
Learn Build status updates of commit ade01f7: ✅ Validation status: passed
For more details, please refer to the build report. |
1 participant
Summary
Splits the reference-docs generation pipeline into two independent stages so v1.0 and beta each produce their own reviewable PR.
v1stage generates the v1.0 docs (including theMicrosoft.Graph.Authenticationmodule), post-processes, pushesWeeklyReferenceDocsUpdate-v1.0_*, and opens its own PR.betastage does the same, scoped to beta, on its own branch and PR.dependsOn: []) on fresh agents; artifacts are suffixed per profile (MissingExternalDocs-v1.0/-beta).Changes
azure-pipelines/common-templates/generate-docs-steps.ymlparameterized byGraphProfile, branch prefix, and PR title/body.azure-pipelines/powershell-docs.ymlrestructured into thev1andbetastages.-GraphProfile(v1.0/beta/both, defaultboth) parameter to the generation/post-processing scripts so each stage only touches its profile. Authentication generation/cleanup runs only in the v1.0 path.Validation
bothwhen run manually.