1---
 2title: Release Notes
 3description: "Guide to release notes for Zed development."
 4---
 5
 6# Release Notes
 7
 8Whenever you open a pull request, the body is automatically populated based on this [pull request template](https://github.com/zed-industries/zed/blob/main/.github/pull_request_template.md).
 9
10```md
11...
12
13Release Notes:
14
15- N/A _or_ Added/Fixed/Improved ...
16```
17
18On Wednesdays, we run [`get-preview-channel-changes`](https://github.com/zed-industries/zed/blob/main/script/get-preview-channel-changes), which collects `Release Notes` lines from pull requests landing in preview, as described in the [Release](https://zed.dev/docs/development/release-notes) docs.
19
20The script outputs everything below the `Release Notes` line, including metadata such as the pull request author (if they are not a Zed team member) and a link to the pull request.
21If you use `N/A`, the script skips your pull request entirely.
22
23## Guidelines for crafting your `Release Notes` line(s)
24
25- A `Release Notes` line should only be written if the user can see or feel the difference in Zed.
26- A `Release Notes` line should be written such that a Zed user can understand what the change is.
27  Don't assume a user knows technical editor developer lingo; phrase your change in language they understand as a user of a text editor.
28- If you want to include technical details about your pull request for other team members to see, do so above the `Release Notes` line.
29- Changes to docs should be labeled as `N/A`.
30- If your pull request adds/changes a setting or a keybinding, always mention that setting or keybinding.
31  Don't make the user dig into docs or the pull request to find this information (although it should be included in docs as well).
32- For pull requests that are reverts:
33  - If the item being reverted **has already been shipped**, include a `Release Notes` line explaining why we reverted, as this is a breaking change.
34- If the item being reverted **hasn't been shipped**, edit the original PR's `Release Notes` line to `N/A`; otherwise, it will still be included and the release notes compiler may not know to skip it.