Skip to content

docs: Update the formatting section for Python#48904

Merged
yeskunall merged 2 commits intozed-industries:mainfrom
lingyaochu:python-doc
Feb 11, 2026
Merged

docs: Update the formatting section for Python#48904
yeskunall merged 2 commits intozed-industries:mainfrom
lingyaochu:python-doc

Conversation

@lingyaochu
Copy link
Copy Markdown
Contributor

@lingyaochu lingyaochu commented Feb 11, 2026

I have added the code_actions_on_format setting. I also temporarily removed the mention of "formatter": null. Based on our findings in #48600, its current behavior is inconsistent, so I've omitted it for now to avoid confusing users. I will add it back once the underlying issue is fixed (likely in a subsequent PR).

Closes #48600.

  • Tests or screenshots needed?
  • Code Reviewed
  • Manual QA

Release Notes:

  • N/A

@cla-bot cla-bot bot added the cla-signed The user has signed the Contributor License Agreement label Feb 11, 2026
@github-actions github-actions bot added the community champion Issues filed by our amazing community champions! 🫶 label Feb 11, 2026
@maxdeviant maxdeviant changed the title docs: update the formatting section of Python docs: Update the formatting section for Python Feb 11, 2026
@yeskunall yeskunall self-assigned this Feb 11, 2026
Copy link
Copy Markdown
Member

@yeskunall yeskunall left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I’m going to make some changes to make them more consistent with our existing docs, but otherwise this looks good!

@yeskunall yeskunall enabled auto-merge (squash) February 11, 2026 08:32
@yeskunall
Copy link
Copy Markdown
Member

Thanks @lingyaochu! 💖

@yeskunall yeskunall merged commit 8f70765 into zed-industries:main Feb 11, 2026
28 checks passed
@lingyaochu lingyaochu deleted the python-doc branch February 11, 2026 10:55
Veykril pushed a commit that referenced this pull request Mar 17, 2026
Related issue #48600, following #48904

Setting `"formatter": null` does not actually disable the formatter, as
it is functionally equivalent to leaving the setting undefined. In this
case, Zed falls back to the default behavior—either "auto" or a specific
language server, depending on the language.

This PR adds a "none" option to the formatter setting, allowing users to
explicitly disable formatting while keeping `code_actions_on_format`
enabled separately.
```json
"formatter": "none"
```

I still have some doubts about the necessity of this setting itself, but
if it is a desired addition, I will update the documentation
accordingly. If not, please feel free to close this PR.

- [x] Tests or screenshots needed?
- [x] Code Reviewed
- [x] Manual QA

Release Notes:

- Added `"formatter": "none"` in settings to explicitly disable the
formatter.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed The user has signed the Contributor License Agreement community champion Issues filed by our amazing community champions! 🫶

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Can't turn off or change Python formatter

2 participants