Skip to content

docs: reorganize guide document layout - #2684

Merged
fengmk2 merged 24 commits into
voidzero-dev:mainfrom
liangmiQwQ:experimental-doc-reorganize
Sep 14, 2026
Merged

fengmk2 merged 24 commits into
voidzero-dev:mainfrom
liangmiQwQ:experimental-doc-reorganize

Conversation

@liangmiQwQ

@liangmiQwQ liangmiQwQ commented Sep 13, 2026

Copy link
Copy Markdown
Collaborator

Close #2503.

This PR reorganizes the guide document.

It clarifies the use cases of global cli and project cli, and adds some recommendation to use Vite+.

It also removes some outdated or overly bloated documents.

Comment thread docs/guide/upgrade-project.md Outdated
@liangmiQwQ
liangmiQwQ marked this pull request as ready for review September 14, 2026 14:18
@liangmiQwQ
liangmiQwQ marked this pull request as draft September 14, 2026 14:19
@liangmiQwQ
liangmiQwQ marked this pull request as ready for review September 14, 2026 14:21
@liangmiQwQ liangmiQwQ changed the title docs: adjust guide document layout docs: reorganize guide document layout Sep 14, 2026
@liangmiQwQ

Copy link
Copy Markdown
Collaborator Author

#2691 might help review.

@fengmk2 fengmk2 self-assigned this Sep 14, 2026
@fengmk2 fengmk2 added docs-preview Request a docs preview of the current fork PR commit; reapply after updates. and removed docs-preview Request a docs preview of the current fork PR commit; reapply after updates. labels Sep 14, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Cloudflare documentation preview: https://pr-2684-viteplus-dev.voidzero-docs.workers.dev

Commit: 7bd3c55

@fengmk2
fengmk2 merged commit bf6ee5b into voidzero-dev:main Sep 14, 2026
76 of 103 checks passed
@liangmiQwQ
liangmiQwQ deleted the experimental-doc-reorganize branch September 14, 2026 21:52
fengmk2 added a commit that referenced this pull request Sep 18, 2026
This release fixes Homebrew setup, Windows installation, and workspace
dependency commands. It also updates Rolldown, Oxlint, and Oxfmt.

### Fixes & Enhancements

- Homebrew installations complete setup once, retain their bundled CLI,
and direct upgrades to `brew upgrade vite-plus`
([#2729](#2729)), by
@fengmk2.
- Windows installations decode remote legacy PowerShell scripts
correctly
([#2701](#2701)), by
@james-elicx.
- `vp migrate` removes the unsupported React Refresh
`allowCompoundComponents` option and warns about possible lint errors
([#2702](#2702)), by
@fengmk2.
- New monorepo packages use the root lint configuration without a
conflicting nested configuration
([#2667](#2667)), by
@semimikoh.
- Yarn Classic rejects filtered additions and removals instead of
changing unintended dependencies
([#2705](#2705)), by
@jong-kyung.
- Yarn Berry rejects unsupported filtered updates and respects filters
during recursive removal
([#2709](#2709),
[#2712](#2712)), by
@jong-kyung.
- Yarn and Bun warn when a command does not support `--workspace-root`.
Yarn Classic accepts root additions through `vp add` and `vp install
<packages>`
([#2713](#2713)), by
@jong-kyung.
- `vp dedupe` warns about unsupported check options
([#2717](#2717)), by
@jong-kyung.
- Rust command output respects `NO_COLOR`
([#2716](#2716)), by
@liangmiQwQ.
- Windows commands find lowercase shims in directories with
case-sensitive file names
([#2727](#2727)), by
@fengmk2.

### Dependency Updates

- Update `rolldown@1.2.8` to `rolldown@1.2.9`, `oxlint@1.82.0` to
`oxlint@1.83.0`, and `oxfmt@0.67.0` to `oxfmt@0.68.0`. The new lint and
format versions can flag code that passed before. Run `vp fmt` after
upgrading if CI runs `vp check`
([#2725](#2725)), by
@voidzero-guard[bot].

### Docs

- Reorganize the guide and expand the global CLI sections
([#2684](#2684),
[#2715](#2715)), by
@liangmiQwQ.
- Explain Nushell startup requirements and recovery for XDG
installations
([#2704](#2704)), by
@naokihaba.

### Chore

- Add documentation previews for fork PRs
([#2691](#2691)), by
@fengmk2.
- Publish `@voidzero-dev/vite-plus-prompts` with npm releases
([#2707](#2707)), by
@fengmk2.
- Reuse native preview installations and clarify release evidence and
package checks
([#2693](#2693),
[#2708](#2708)), by
@fengmk2.
- Stabilize dependency-removal snapshots and temporarily skip Socket
Firewall tests on Windows
([#2711](#2711),
[#2730](#2730)), by
@fengmk2.
- Clarify package-manager comments and update the preview workflow
reference ([#2706](#2706),
[#2714](#2714)), by
@jong-kyung.
- Run dependency upgrade automation with Kimi K3
([#2723](#2723)), by
@Brooooooklyn.

### Bundled Versions

| Tool | Version | Source |
| --- | --- | --- |
| `vite` | `8.3.0` |
[`434e8e9`](vitejs/vite@434e8e9)
|
| `rolldown` | `1.2.9` |
[`5b4746e`](rolldown/rolldown@5b4746e)
|
| `tsdown` | `0.23.0` | [npm](https://npmx.dev/package/tsdown/v/0.23.0)
|
| `vitest` | `4.1.11` | [npm](https://npmx.dev/package/vitest/v/4.1.11)
|
| `oxlint` | `1.83.0` | [npm](https://npmx.dev/package/oxlint/v/1.83.0)
|
| `oxlint-tsgolint` | `7.0.2001` |
[npm](https://npmx.dev/package/oxlint-tsgolint/v/7.0.2001) |
| `oxfmt` | `0.68.0` | [npm](https://npmx.dev/package/oxfmt/v/0.68.0) |

### Upgrade

```bash
vp upgrade
```

### New Contributors

@james-elicx

**Full Changelog**:
v0.3.2...v0.3.3

---

Merging this PR will trigger the release workflow.

---------

Co-authored-by: voidzero-guard[bot] <278573678+voidzero-guard[bot]@users.noreply.github.com>
Co-authored-by: MK <fengmk2@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-preview Request a docs preview of the current fork PR commit; reapply after updates.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Project-local installation

2 participants