Skip to content

Conversation

@josephjunker
Copy link

Description

As discussed in issue #6331, I think it would be helpful to tell new users what property-based testing is before trying to show them how to do it. I've added a new page at the front of the introduction which aims to do this. I've also made modifications to the "Why Property-Based Testing" page, largely to try to harmonize the two, but also to add some additional points which I feel were missed.

I'm happy to provide background on why I made each of the changes, if desired, or to make/revert any edits as requested.

Checklist

  • The name of my PR follows gitmoji specification
  • My PR references one of several related issues (if any)
    • New features or breaking changes must come with an associated Issue or Discussion
    • My PR does not add any new dependency without an associated Issue or Discussion
  • My PR includes bumps details, please run pnpm run bump and flag the impacts properly
  • My PR adds relevant tests and they would have failed without my PR (when applicable)

I'm not clear on whether I was supposed to run bump for a documentation change, so I left it out. Please let me know if that was incorrect!

Advanced

  • Category: 📝 Add or update documentation
  • Impacts: The "Introduction" section of the docs

@josephjunker josephjunker requested a review from dubzzz as a code owner December 23, 2025 18:26
@changeset-bot
Copy link

changeset-bot bot commented Dec 23, 2025

⚠️ No Changeset found

Latest commit: 0c4a9a9

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

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.

1 participant