Skip to content

Add testing plan guide to documentation.#4113

Merged
ptomato merged 2 commits intotc39:mainfrom
ioannad:testing-plan-guide
Apr 15, 2025
Merged

Add testing plan guide to documentation.#4113
ptomato merged 2 commits intotc39:mainfrom
ioannad:testing-plan-guide

Conversation

@ioannad
Copy link
Contributor

@ioannad ioannad commented Jun 20, 2024

A guide to help with writing testing plans for ECMAScript proposals in stage 2.7.

@ioannad ioannad requested a review from a team as a code owner June 20, 2024 13:31
Copy link
Contributor

@ptomato ptomato left a comment

Choose a reason for hiding this comment

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

Looks like a good first draft to me. Before it's ready for publicizing there are a few things I'd suggest:

  • We should make the document more approachable with a couple of introductory paragraphs, explaining what it is and who it is intended for.
  • We should have a section about diminishing returns and advice on where to draw the line. See, for example, the discussion at #4054 and in Mike's testing plan guide for WPT.
  • We should have a section on what steps to carry out, concretely. Things like, open a testing plan issue on the test262 repo. (Examples of good existing testing plan issues.) CC the proposal champions (if that is not you yourself). Send a PR to tc39/proposals to link the testing plan issue.

Copy link
Contributor

@ptomato ptomato left a comment

Choose a reason for hiding this comment

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

This seems like really good guidance. Any other maintainers want to take a look before merging?

Copy link
Contributor

@Ms2ger Ms2ger left a comment

Choose a reason for hiding this comment

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

Do we want to link this from somewhere?

ioannad and others added 2 commits April 14, 2025 13:24
Hopefully this will catch the notice of proposal champions working on
tests for their stage 2.7 proposal.
@ptomato ptomato force-pushed the testing-plan-guide branch from 318059e to b5ece89 Compare April 14, 2025 20:25
@ptomato
Copy link
Contributor

ptomato commented Apr 14, 2025

I added a blurb in CONTRIBUTING.md that will hopefully catch proposal authors' notice.

@ptomato ptomato merged commit 61fcd7b into tc39:main Apr 15, 2025
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants