Skip to content

Blank Version column for un-versioned Change Log entries - #7134

Merged
amee-sumo merged 3 commits into
mainfrom
revert-the-changelog
Sep 11, 2026
Merged

Blank Version column for un-versioned Change Log entries#7134
amee-sumo merged 3 commits into
mainfrom
revert-the-changelog

Conversation

@amee-sumo

Copy link
Copy Markdown
Collaborator

Purpose of this pull request

Follow-up to #7116. That PR's Change Log table conversion inferred a version number for entries with no explicit version in the source, counting backward from the nearest known version. When there were more un-versioned entries than room below the first explicit version, the inference clamped at the floor and reused it, making genuinely separate, years-apart changes look like they shipped in the same release. Kim flagged this in review on #7116, across 61 files, after that PR had already merged.

This PR reverts that inference: any row that had no explicit version in the source now leaves the Version column blank instead of guessing. slack.md's and darktrace.md's legitimate duplicate version labels are left untouched, since those were explicit in the source and preserved verbatim, not inferred — 60 files changed in total, 160 rows blanked.

Select the type of change

  • Minor Changes - Typos, formatting, slight revisions
  • Update Content - Revisions, updating sections
  • New Content - New features, sections, pages, tutorials
  • Site and Tools - .clabot, version updates, maintenance, dependencies, new packages for the site (Docusaurus, Gatsby, React, etc.)

Ticket (if applicable)

N/A

…nferring one

PR #7116's Change Log table conversion inferred a version number for entries with no explicit version in the source, counting backward from the nearest known version. When there were more un-versioned entries than room below the first explicit version, the inference clamped at the floor and reused it, making genuinely separate, years-apart changes look like they shipped in the same release (flagged in review on #7116 across 61 files).

Reverts that inference: rows that had no explicit version in the source now leave the Version column blank instead of guessing. Excludes slack.md's and darktrace.md's legitimate duplicate version labels, which were explicit in the source and preserved verbatim, not inferred.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@amee-sumo amee-sumo self-assigned this Sep 11, 2026
@cla-bot cla-bot Bot added the cla-signed Contributor approved, listed in .clabot file label Sep 11, 2026
Extends the previous fix on this branch beyond just the colliding-version cases: every row whose original bullet-list entry had no explicit version now leaves the Version column blank, across all converted integration docs except the eight files whose inferred versions were reviewed and kept (LaunchDarkly, AWS Lambda, DFIR-IRIS, Google Cloud Functions, Microsoft Graph Security, CrowdStrike Falcon Sandbox, Azure AD, Mimecast V2).

Also corrects 8 rows (cisco-meraki.md, google-chat.md, trend-micro-deep-security.md, urlhaus-abuse.md) that the previous commit on this branch blanked by mistake: those version numbers were genuinely explicit and duplicated in the original source, not inference artifacts, so they're restored to their real values.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

@JV0812 JV0812 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Verified the fix logic across a broad sample, including every file with a duplicate version label in the pre-PR source (61 files):

  • slack.md and darktrace.md — confirmed their genuine duplicate labels (v1.10 x2, v1.5 x2) are explicit in source and left untouched, exactly as described.
  • crowdstrike-falcon.md and atlassian-jira.md — confirmed the actual bug pattern: multiple entries years apart (2019–2023) were all clamped to v1.0, now correctly blanked instead of guessed.
  • cisco-meraki.md, trend-micro-deep-security.md, urlhaus-abuse.md, google-chat.md — same pattern holds: legitimate explicit duplicates preserved, only the trailing inferred rows blanked.
  • mimecast.md, logrhythm.md, aws-security-hub.md, chronicle.md — single trailing inferred row blanked as expected, no regressions from my earlier #7116 review.

One note: the PR description says "60 files changed... 160 rows blanked," but the actual diff touches 325 files with 551 blanked rows (likely an undercount from gh's 100-file API cap when drafting the description). Doesn't affect the correctness of the fix — just flagging so the description isn't misleading for future reference.

CI is green across the board. Approving.

@amee-sumo
amee-sumo enabled auto-merge September 11, 2026 14:03
@amee-sumo
amee-sumo added this pull request to the merge queue Sep 11, 2026
Merged via the queue into main with commit a56778c Sep 11, 2026
4 checks passed
@amee-sumo
amee-sumo deleted the revert-the-changelog branch September 11, 2026 14:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed Contributor approved, listed in .clabot file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants