Skip to content

Add blog post announcing SEP process migration to PRs#1851

Merged
dsp-ant merged 3 commits intomainfrom
sep-process-blog-post
Nov 28, 2025
Merged

Add blog post announcing SEP process migration to PRs#1851
dsp-ant merged 3 commits intomainfrom
sep-process-blog-post

Conversation

@dsp-ant
Copy link
Member

@dsp-ant dsp-ant commented Nov 20, 2025

Summary

Adds a blog post announcing the migration of the SEP process from GitHub issues to pull requests.

Dependencies

This PR is based on #1850 (the SEP process changes) and should be merged after that PR.

Blog Post Contents

  • Explains why we're making the change (scattered discussions, no version history, manual number assignment)
  • Describes the new PR-based workflow
  • Clarifies that sponsors now manage status updates
  • Provides guidance for existing SEPs and new proposals
  • Links to updated documentation

Preview

The blog post follows the same tone as existing posts like "Building to Last: A New Governance Model for MCP" - straightforward engineering communication that explains the what, why, and how.

🤖 Generated with Claude Code

@dsp-ant dsp-ant requested a review from a team November 20, 2025 14:50
@dsp-ant dsp-ant force-pushed the sep-process-blog-post branch from cbba22e to 17fe95f Compare November 20, 2025 14:51
@dsp-ant dsp-ant requested a review from pcarleton November 20, 2025 14:52
pcarleton
pcarleton previously approved these changes Nov 20, 2025

## Existing SEPs

If you have an open SEP as a GitHub issue, don't worry. Existing proposals can continue through their current workflow. However, we encourage new proposals to use the PR-based process going forward. We are moving all implemented SEPs

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we be more explicit on the guidance here? Can existing proposals migrate to this? If not change to existing proposals must


## What About Status?

One notable change: **sponsors are now responsible for updating SEP status**. In addition to applying labels to the pull request, the sponsor updates the `Status` field directly in the SEP markdown file. This keeps the canonical state of the proposal in the file itself, versioned alongside the content, while PR labels make it easy to filter and find SEPs by status.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

since there's many PR's, can we make sure every PR gets the SEP tag for filtering? There's many PR's not tagged with SEP as is prior to this process addition.

Should the direction be that PR creator must include SEP label? And / Or PR naming must follow consistent naming format [SEP-xxx] Name. Currently the PR naming convention isn't consistent


## What About Status?

One notable change: **sponsors are now responsible for updating SEP status**. In addition to applying labels to the pull request, the sponsor updates the `Status` field directly in the SEP markdown file. This keeps the canonical state of the proposal in the file itself, versioned alongside the content, while PR labels make it easy to filter and find SEPs by status.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
One notable change: **sponsors are now responsible for updating SEP status**. In addition to applying labels to the pull request, the sponsor updates the `Status` field directly in the SEP markdown file. This keeps the canonical state of the proposal in the file itself, versioned alongside the content, while PR labels make it easy to filter and find SEPs by status.
One notable change: **sponsors are now responsible for updating SEP status**. In addition to applying labels to the pull request (such as `SEP` for all submitted SEPs), the sponsor updates the `Status` field directly in the SEP markdown file. This keeps the canonical state of the proposal in the file itself, versioned alongside the content, while PR labels make it easy to filter and find SEPs by status.

Base automatically changed from sep-process-pr-based to main November 28, 2025 14:33
@dsp-ant dsp-ant dismissed pcarleton’s stale review November 28, 2025 14:33

The base branch was changed.

@dsp-ant
Copy link
Member Author

dsp-ant commented Nov 28, 2025

Thank you @localden ! I added most of these suggestion and rewrote the post quite a bit.

@bdoyle0182 Thank you! I Think since we accepted the SEP without forcing a migration, I'll keep it as is.

@dsp-ant dsp-ant force-pushed the sep-process-blog-post branch from 4917bfd to b8592a9 Compare November 28, 2025 15:04
- Remove casual "back in" phrasing
- Clarify dual numbering issue
- Simplify commit instructions for less experienced Git users
- Add guidance on preserving discussion history during migration

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@dsp-ant dsp-ant merged commit 80aefdf into main Nov 28, 2025
7 checks passed
@dsp-ant dsp-ant deleted the sep-process-blog-post branch November 28, 2025 15:11
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.

4 participants