Skip to content

fix: file-a-bug → new issue form; update README doc links#5138

Open
marcoscaceres wants to merge 2 commits intomainfrom
fix/file-a-bug-link
Open

fix: file-a-bug → new issue form; update README doc links#5138
marcoscaceres wants to merge 2 commits intomainfrom
fix/file-a-bug-link

Conversation

@marcoscaceres
Copy link
Copy Markdown
Contributor

@marcoscaceres marcoscaceres commented Mar 28, 2026

Changes

src/core/github.jsFix #3457 (High priority since 2021)

The "File an issue" link in spec headers was pointing to /issues (the list) instead of /issues/new/choose (the new issue form). newIssuesURL was already computed at line 215 but not used for this link. Also extracted the URL construction to a shared variable to avoid duplication.

README.md

  • Primary user documentation links (User's guide, WebIDL guide) now point to respec.org/docs instead of raw wiki URLs
  • specref.org link upgraded to HTTPS

@marcoscaceres marcoscaceres force-pushed the fix/file-a-bug-link branch 5 times, most recently from 71957a9 to 95d7009 Compare March 28, 2026 12:34
- github.js: 'File an issue' now links to /issues/new/choose (new issue
  form) instead of /issues (list). The list was making spec editors hunt
  for a way to file a new bug. newIssuesURL was already computed but unused
  for this link. Fixes #3457 (High priority since 2021).

- README.md: documentation links now point to respec.org/docs instead of
  the raw wiki URLs; wiki is the source but respec.org/docs is the rendered
  single-page version that's much easier to read.

- README.md: specref.org link upgraded from http:// to https://
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates GitHub-related UX and documentation links so users land on the correct GitHub “new issue” flow and on the rendered ReSpec docs site rather than the raw wiki.

Changes:

  • Point “File a bug” header link to GitHub’s /issues/new/choose instead of the issues list.
  • Update core GitHub module tests to assert the new “File a bug” URL.
  • Refresh README documentation URLs to https://respec.org/docs/ and upgrade specref to HTTPS.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
src/core/github.js Adjusts the “File a bug” participate link target to GitHub’s new-issue chooser URL.
tests/spec/core/github-spec.js Updates expectations so tests validate the new issue-form URL.
README.md Switches key docs links to respec.org/docs and upgrades specref to HTTPS.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@sidvishnoi
Copy link
Copy Markdown
Member

Not keeping link to all issues and just adding file new issue link?

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.

Link target of 'File a Bug' is not new issue but a list of issues

3 participants