Add new docs site by bluwy · Pull Request #1979 · changesets/changesets

bluwy · 2026-05-06T06:42:39Z

Ready to merge. It's at a state where most drastic changes are done, and changes later can be made as PRs.

Netlify may need to be updated later to use main as the target branch for deployments.

NO NEED TO NORMAL MERGE THIS. JUST SQUASH MERGE.

https://changesets.dev

Co-authored-by: bluwy <bjornlu.dev@gmail.com>

changeset-bot · 2026-05-06T06:42:44Z

⚠️ No Changeset found

Latest commit: b730ff4

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

codecov · 2026-05-06T06:43:41Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.46%. Comparing base (3910adf) to head (b730ff4).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1979      +/-   ##
==========================================
- Coverage   84.57%   84.46%   -0.12%     
==========================================
  Files          80       80              
  Lines        3125     3135      +10     
  Branches      878      887       +9     
==========================================
+ Hits         2643     2648       +5     
- Misses        427      432       +5     
  Partials       55       55

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

socket-security · 2026-05-06T06:43:42Z

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	takumi-js@2.1.1
	vitepress@2.0.0-alpha.18
	vitepress-plugin-group-icons@1.7.5

View full report

beeequeue

i still don't have write access, but i can do it this way instead :^)

Co-authored-by: Adam Haglund <adam@haglund.dev>

netlify · 2026-05-12T17:16:05Z

✅ Deploy Preview for changesets ready!

Name	Link
🔨 Latest commit	`b730ff4`
🔍 Latest deploy log	https://app.netlify.com/projects/changesets/deploys/6a678fd4d175a30008da74bf
😎 Deploy Preview	https://deploy-preview-1979--changesets.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

- rewrite getting-started - rewrite concepts -> origins - rewrite common-questions -> faq - delete what-are-changesets (covered in getting-started) - delete dictionary (explain everything inline where possible)

fix #756 Co-authored-by: Melanie Seltzer <melanieseltzer1@gmail.com>

Co-Authored-By: Emmet Moore <130148281+emmet-opinionx@users.noreply.github.com>

socket-security · 2026-07-20T07:14:54Z

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Action	Severity	Alert (click "▶" to expand/collapse)
Warn		Obfuscated code: npm `@emnapi/runtime` is 90.0% likely obfuscated Confidence: 0.90 Location: Package overview From: pnpm-lock.yaml → `npm/vitepress-plugin-group-icons@1.7.5` → `npm/vitest@4.1.10` → `npm/vitepress@2.0.0-alpha.18` → `npm/tsdown@0.22.4` → `npm/@emnapi/runtime@1.11.1` ℹ Read more on: This package \| This alert \| What is obfuscated code? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at `support@socket.dev`. Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment `@SocketSecurity ignore npm/@emnapi/runtime@1.11.1`. You can also ignore all packages with `@SocketSecurity ignore-all`. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.

View full report

Co-authored-by: Emelia Smith <ThisIsMissEm@users.noreply.github.com>

beeequeue

small comments i added while reviewing, not blocking though

beeequeue · 2026-07-29T08:42:48Z

+In this approach, a pull request may be merged if no changeset is present, and a missing changeset does not cause a failure in CI. Our [Changesets GitHub Bot](https://github.com/apps/changeset-bot) is the best way to prompt for changesets without making them blocking.
+
+It comments on PRs of whether changesets are present and gives you link to add your own changeset as a maintainer to smooth over merging pull requests without waiting for the contributor to add a changeset.
+


missing the new action

I'll update this part altogether later

beeequeue · 2026-07-29T08:43:55Z

+
+```json [.changeset/config.json]
+{
+  "baseBranch": "v1"


should we recommend using the same pattern we do (maintenance/vX)?

Yeah I think we can change this if we also mention that for automation to set the glob as "maintenance/v*"

akinoccc and others added 8 commits May 5, 2026 10:56

Add a docs site for changesets (#1512)

5bdd59d

Co-authored-by: bluwy <bjornlu.dev@gmail.com>

Update docs

20b2d7f

Remove docsearch dependencies

5bab571

Adjust colors

b6644e0

Move pages

608502a

Improve code blocks

4f8ae0b

Add group icons

ddb88d9

Add head tags

a7ba9c7

bluwy added 2 commits May 6, 2026 17:54

Merge branch 'next' into next-docs

3ddd853

Fix lint error

b84d608

beeequeue reviewed May 6, 2026

View reviewed changes

Comment thread site/index.md Outdated

Comment thread site/.vitepress/theme/custom.css

bluwy and others added 6 commits May 6, 2026 23:56

Apply suggestions from code review

13f43a8

Co-authored-by: Adam Haglund <adam@haglund.dev>

Merge branch 'next' into next-docs

5e4f278

Simplify main readme

c3941ac

Add Netlify stuff

1eeb225

Merge branch 'next' into next-docs

e5f6155

Update picomatch links

377d072

packageManager with h4sh

c420741

Andarist force-pushed the next-docs branch from 77bbc93 to 0edd3d8 Compare May 13, 2026 07:05

update local node version

eaf15a5

Andarist force-pushed the next-docs branch from 0edd3d8 to eaf15a5 Compare May 13, 2026 07:05

bluwy added 5 commits May 18, 2026 11:10

Merge branch 'next' into next-docs

2690fa1

Fix lint

1b9b483

Rewrite intro pages

1a410a1

- rewrite getting-started - rewrite concepts -> origins - rewrite common-questions -> faq - delete what-are-changesets (covered in getting-started) - delete dictionary (explain everything inline where possible)

Fix site build

17f7e5f

Tweak styles

574bcb6

bluwy and others added 17 commits June 30, 2026 13:34

Document accidental new package publish

238700d

fix #756 Co-authored-by: Melanie Seltzer <melanieseltzer1@gmail.com>

Merge branch 'main' into next-docs

9d22e48

Update git-tag docs

53ff1ca

docs: make init command interactive (#2088)

829b256

Add packages pages

b34036d

docs: create page for GitHub generator package (#2127)

cb3df7f

Add warnings for old docs pages

398bee8

Update changelog github docs

ffb9099

Add more popular-ish packages docs

7077b51

Tweak wording

24c19b3

Add basic migration page

7526f48

docs: update and enhance comparison to other tools (#2126)

bfffc50

update pnpm

13b0079

update vitepress

d1d93ca

add changes from #2150

e0eef87

Co-Authored-By: Emmet Moore <130148281+emmet-opinionx@users.noreply.github.com>

Add blog pages and og images (#2154)

70e83ef

Merge branch 'main' into next-docs

d6fb955

beeequeue and others added 4 commits July 20, 2026 09:17

remove unnecessary property

6b6d3a2

Add private packages docs

72289ec

Co-authored-by: Emelia Smith <ThisIsMissEm@users.noreply.github.com>

Merge branch 'main' into next-docs

e09d6d5

Update as beyond npm

b730ff4

bluwy marked this pull request as ready for review July 27, 2026 17:05

Andarist enabled auto-merge July 29, 2026 07:35

Andarist approved these changes Jul 29, 2026

View reviewed changes

Andarist added this pull request to the merge queue Jul 29, 2026

Merged via the queue into main with commit 1b9687f Jul 29, 2026
54 of 63 checks passed

Andarist deleted the next-docs branch July 29, 2026 09:05

beeequeue reviewed Jul 29, 2026

View reviewed changes

Navigation Menu

Uh oh!

Uh oh!

Add new docs site - #1979

Add new docs site#1979
Andarist merged 94 commits into
mainfrom
next-docs

bluwy commented May 6, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented May 6, 2026 •

edited

Loading

Uh oh!

codecov Bot commented May 6, 2026 •

edited

Loading

Uh oh!

socket-security Bot commented May 6, 2026 •

edited

Loading

Uh oh!

beeequeue left a comment

Uh oh!

Uh oh!

Uh oh!

netlify Bot commented May 12, 2026 •

edited

Loading

Uh oh!

socket-security Bot commented Jul 20, 2026 •

edited

Loading

Uh oh!

Uh oh!

beeequeue left a comment

Uh oh!

beeequeue Jul 29, 2026

Uh oh!

bluwy Jul 29, 2026

Uh oh!

beeequeue Jul 29, 2026

Uh oh!

bluwy Jul 29, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

		In this approach, a pull request may be merged if no changeset is present, and a missing changeset does not cause a failure in CI. Our [Changesets GitHub Bot](https://github.com/apps/changeset-bot) is the best way to prompt for changesets without making them blocking.

		It comments on PRs of whether changesets are present and gives you link to add your own changeset as a maintainer to smooth over merging pull requests without waiting for the contributor to add a changeset.

Uh oh!

Uh oh!

Conversation

bluwy commented May 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented May 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

codecov Bot commented May 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

socket-security Bot commented May 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

beeequeue left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

netlify Bot commented May 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for changesets ready!

Uh oh!

socket-security Bot commented Jul 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

beeequeue left a comment

Choose a reason for hiding this comment

Uh oh!

beeequeue Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

bluwy Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

beeequeue Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

bluwy Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

bluwy commented May 6, 2026 •

edited

Loading

changeset-bot Bot commented May 6, 2026 •

edited

Loading

codecov Bot commented May 6, 2026 •

edited

Loading

socket-security Bot commented May 6, 2026 •

edited

Loading

netlify Bot commented May 12, 2026 •

edited

Loading

socket-security Bot commented Jul 20, 2026 •

edited

Loading