Skip to content

docs: fix broken CloudEvents spec link in source comment - #668

Merged
duglin merged 1 commit into
cloudevents:mainfrom
fairbearlab:fix/spec-doc-links
Nov 6, 2026
Merged

duglin merged 1 commit into
cloudevents:mainfrom
fairbearlab:fix/spec-doc-links

Conversation

@fairbearlab

Copy link
Copy Markdown
Contributor

Proposed Changes

  • Update the one remaining broken cloudevents/spec link in source code:
    src/event/cloudevent.ts (a // code comment above the extension value
    type check) pointed at blob/master/spec.md#type-system, which now 404s.
    It now points at blob/main/cloudevents/spec.md#type-system.

Related to #667. Same root cause: cloudevents/spec renamed its default branch
from master to main and moved spec.md into cloudevents/. #667 fixes the
README community links; this PR does not touch the README.

Description

Only the URL text changed (one line, no reflow). The link is in a plain code
comment, so it is not shown in generated docs or to library users.

Verification:

  • Checked every github.com/cloudevents/spec URL in src/ and test/ with
    curl. The only one returning 404 was the master/spec.md link above. The
    rest are pinned to tags (v1.0, v1.0.1) and still return 200, so they are
    left alone.
  • The #type-system anchor was checked against the raw markdown: main's
    cloudevents/spec.md has a ### Type System heading, which produces that slug.
  • Left unchanged on purpose: the CHANGELOG.md entry that links to the old
    master/spec.md (historical record) and the README links (handled in docs: fix broken CloudEvents community links in README #667).
  • npx eslint src/event/cloudevent.ts passes; git diff --check is clean.

The cloudevents/spec repository renamed its default branch from master
to main and moved spec.md under cloudevents/. Update the code comment in
CloudEvent validation that still pointed at the old, now 404, location.

Signed-off-by: Adam Boulware <adam@adamboulware.com>
@shiva

shiva commented Nov 6, 2026

Copy link
Copy Markdown
Contributor

LGTM

@duglin
duglin merged commit 4b17763 into cloudevents:main Nov 6, 2026
9 checks passed
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.

3 participants