Skip to content

Clarify Segment Spec guidance and remove legacy references to "Blocks" #7803

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 3 commits into from
Jul 31, 2025
Merged

Clarify Segment Spec guidance and remove legacy references to "Blocks" #7803

merged 3 commits into from
Jul 31, 2025

Conversation

pwseg
Copy link
Contributor

@pwseg pwseg commented Jul 30, 2025

Proposed changes

  • Rewrote Message schemas, Blocks and Specs section to use clearer/up-to-date terminology that aligns with current product behavior.
  • Specifically, it removes references to “Blocks,” which are no longer a relevant or supported concept.
  • Also emphasized what parts of the Segment Spec result in downstream transformations (mapped events), versus what are just recommendations.

Merge timing

  • ASAP once approved

Related issues (optional)

@pwseg pwseg added the content-update updates to content that are not new features, includes grammar fixes, added notes label Jul 30, 2025
@pwseg pwseg linked an issue Jul 30, 2025 that may be closed by this pull request
[Content]: You can probably remove "blocks"? #6100
Closed
@pwseg pwseg requested a review from forstisabella July 30, 2025 02:09
@pwseg pwseg marked this pull request as ready for review July 30, 2025 02:09
@pwseg pwseg requested a review from a team as a code owner July 30, 2025 02:09
forstisabella
forstisabella previously approved these changes Jul 30, 2025
View reviewed changes
sanscontext
sanscontext approved these changes Jul 30, 2025
View reviewed changes
Copy link
Contributor

@sanscontext sanscontext left a comment

Choose a reason for hiding this comment

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

🫡

@pwseg @forstisabella
Update src/guides/intro-impl.md
db7f537 
Co-authored-by: forstisabella <92472883+forstisabella@users.noreply.github.com>
@pwseg pwseg enabled auto-merge July 31, 2025 00:08
@pwseg pwseg merged commit cc43b92 into develop Jul 31, 2025
4 checks passed
@pwseg pwseg deleted the 6100-content-you-can-probably-remove-blocks branch July 31, 2025 13:38
@github-actions GitHub Actions
Copy link
Contributor

Thank you for your contribution! Your pull request is merged, but may take a day or two to appear on the site.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@sanscontext sanscontext sanscontext approved these changes

@forstisabella forstisabella forstisabella approved these changes

Assignees
No one assigned
Labels
content-update updates to content that are not new features, includes grammar fixes, added notes
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

[Content]: You can probably remove "blocks"?
3 participants
@pwseg @sanscontext @forstisabella