62 lines
2.4 KiB
Plaintext
62 lines
2.4 KiB
Plaintext
|
---
|
||
|
|
title: Feedback
|
||
|
|
description: Share feedback, bug reports, and feature requests
|
||
|
|
mode: center
|
||
|
|
---
|
||
|
|
|
||
|
|
Here's how to open a helpful issue for a bug, a performance problem, or a feature request:
|
||
|
|
|
||
|
|
<Callout icon="discord">For general questions, join the [Discord](https://bun.com/discord).</Callout>
|
||
|
|
|
||
|
|
## Reporting Issues
|
||
|
|
|
||
|
|
<Steps>
|
||
|
|
<Step title="Upgrade Bun">
|
||
|
|
Upgrade Bun to the latest version with `bun upgrade`. This might fix your problem without opening an issue.
|
||
|
|
|
||
|
|
```bash terminal icon="terminal"
|
||
|
|
bun upgrade
|
||
|
|
```
|
||
|
|
|
||
|
|
You can also try the latest canary release, which includes changes and bug fixes that haven't reached a stable release yet.
|
||
|
|
|
||
|
|
```bash terminal icon="terminal"
|
||
|
|
bun upgrade --canary
|
||
|
|
|
||
|
|
# To revert to the stable release
|
||
|
|
bun upgrade --stable
|
||
|
|
```
|
||
|
|
|
||
|
|
If the issue persists after upgrading, continue to the next step.
|
||
|
|
</Step>
|
||
|
|
<Step title="Review Existing Issues">
|
||
|
|
Check whether the issue has already been reported before opening a new one. Checking first saves time for everyone and helps us focus on fixing things.
|
||
|
|
|
||
|
|
- 🔍 [**Search existing issues**](https://github.com/oven-sh/bun/issues)
|
||
|
|
- 💬 [**Check discussions**](https://github.com/oven-sh/bun/discussions)
|
||
|
|
|
||
|
|
If you find a related issue, add a 👍 reaction or comment with extra details instead of opening a new one.
|
||
|
|
</Step>
|
||
|
|
<Step title="Report the Issue">
|
||
|
|
If no one has reported the issue, open a new one or suggest an improvement.
|
||
|
|
|
||
|
|
- 🐞 [**Report a Bug**](https://github.com/oven-sh/bun/issues/new?template=2-bug-report.yml)
|
||
|
|
- ⚡ [**Suggest an Improvement**](https://github.com/oven-sh/bun/issues/new?template=4-feature-request.yml)
|
||
|
|
|
||
|
|
Provide as much detail as possible, including:
|
||
|
|
- A clear and concise title
|
||
|
|
- A code example or steps to reproduce the issue
|
||
|
|
- The version of Bun you are using (run `bun --version`)
|
||
|
|
- A description of the issue (what you expected to happen and what actually happened)
|
||
|
|
- The operating system and version you are using
|
||
|
|
<Note>
|
||
|
|
- For macOS and Linux: copy the output of `uname -mprs`
|
||
|
|
- For Windows: copy the output of this command in the PowerShell console:
|
||
|
|
`"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"`
|
||
|
|
</Note>
|
||
|
|
</Step>
|
||
|
|
|
||
|
|
</Steps>
|
||
|
|
|
||
|
|
The Bun team will review the issue and get back to you as soon as possible.
|