Skip to content

Route publication contributions through public pull requests - #894

Merged
Brandon Miller (brandom-msft) merged 8 commits into
mainfrom
brandom-msft-public-first-docs
Aug 26, 2026
Merged

Route publication contributions through public pull requests#894
Brandon Miller (brandom-msft) merged 8 commits into
mainfrom
brandom-msft-public-first-docs

Conversation

@brandom-msft

@brandom-msft Brandon Miller (brandom-msft) commented Aug 7, 2026

Copy link
Copy Markdown
Member

Summary

  • make a public same-repository pull request the normal contributor route for changes intended for publication
  • require sample changes to use same-repository branches because the required trusted gate intentionally rejects fork pull requests
  • state that required checks must pass and maintainers initiate normal contributor merges
  • distinguish the retained manual, operator-only bridge for approved private-owned content: it is not a contributor route, publishes through a public pull request after required checks, and the sync App rebase-merges under the active public ruleset with no bypass actors
  • remove private-staging, promotion, transition taxonomy, and automated handoff guidance

Scope

This PR changes only README.md and CONTRIBUTING.md. It does not change workflows, rulesets, CODEOWNERS, samples, notebooks, or repository settings.

Activation gate

Keep this PR in Draft until:

  1. contributor wording is approved by the designated AI Platform Docs documentation owner;
  2. the public trusted validation lane is restored after force-full sync commit 1a7f828fd60e6b0f14549612cf25e7bf2c906931 removed it;
  3. P5.2 proves the constrained retained-bridge boundary: public mirror workflow 289478915 remains disabled; private sync workflow 233646160 remains manual and operator-only for approved private-owned content; the bridge opens a public pull request, waits for required checks, and the sync App rebase-merges under active public ruleset 6131793, whose bypass actor list is empty; the bridge is not documented or exposed as a contributor route.

At activation, merge this public guidance first through the normal human-triggered public merge path, then merge the coordinated private guidance in microsoft-foundry/foundry-samples-pr#895.

Tracking

Validation

  • git diff --check
  • final changed-file review limited to README.md and CONTRIBUTING.md
  • normal pull-request checks, including required trusted, after restoration of the deleted validation lane

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
foundry-samples-repo-sync Bot pushed a commit that referenced this pull request Aug 8, 2026
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 002c35aa-a47b-4b64-91ff-9577c98a4af6
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@brandom-msft Brandon Miller (brandom-msft) changed the title Prepare public-first contribution documentation Route publication contributions through public pull requests Aug 13, 2026
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 98973444-5613-41ce-94a1-3798e2e8a3f0
@brandom-msft

Copy link
Copy Markdown
Member Author

Sheri Gilley (@sdgilley) This is ready for AI Platform Docs owner review. The focused diff changes only README.md and CONTRIBUTING.md; P5.2 writer shutdown and public-only routing activation remain blocked on your explicit approval.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 98973444-5613-41ce-94a1-3798e2e8a3f0
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 4abf4f12-bfac-4353-a354-3782bcbc6325
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: e9d02cb5-ca20-4172-ab90-3686a4a9824f
@brandom-msft
Brandon Miller (brandom-msft) marked this pull request as ready for review August 26, 2026 00:58
@brandom-msft
Brandon Miller (brandom-msft) merged commit 71dd35f into main Aug 26, 2026
12 checks passed
@brandom-msft
Brandon Miller (brandom-msft) deleted the brandom-msft-public-first-docs branch August 26, 2026 01:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants