[DOCS] Settings docs still mention removed startup "setup issues" notice

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

The "Verify active settings" subsection, especially the paragraph describing how invalid settings.json files surface to the user.

Current Documentation

The Settings page currently says:

If a settings file contains errors, such as invalid JSON or a value that fails validation, Claude Code shows a setup issues notice at startup and /status lists the affected files. Run /doctor to see the details for each error.

What's Wrong or Missing?

A. The page describes a startup UI that v2.1.183 removed

The v2.1.183 changelog says:

Removed the startup "setup issues" line under the logo — run /doctor to see configuration issues or use --debug

That makes the Settings page factually outdated. Readers are told to expect a startup "setup issues" notice that no longer appears.

B. The troubleshooting flow still pivots off the removed notice instead of the current diagnostics

The current sentence frames /doctor as the follow-up after seeing the startup notice. After v2.1.183, the product guidance is to run /doctor directly, with --debug available when users need deeper diagnostic output. Readers using the Settings page can waste time looking for a startup indicator that Claude Code no longer shows.

Suggested Improvement

Update the sentence in Settings so it reflects the current behavior, for example:

If a settings file contains errors, run /doctor to see the affected files and validation details. If you need deeper diagnostics, start Claude Code with --debug and inspect the debug log.

If /status still lists the affected files, keep that part of the guidance. The key fix is to remove the claim that Claude Code shows a startup "setup issues" notice.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/settings | 643 | "shows a setup issues notice at startup" guidance in the "Verify active settings" subsection |

Total scope: 1 page affected

Version: Claude Code v2.1.183

Changelog cross-reference: https://code.claude.com/docs/en/changelog documents the release note "Removed the startup \"setup issues\" line under the logo — run /doctor to see configuration issues or use --debug."

Related docs: https://code.claude.com/docs/en/debug-your-config already tells readers to use /doctor and debug logging, so the Settings page can align with that workflow.