Skip to content

Remove legacy inspector documentation - #13233

Closed
crackedhandle wants to merge 2 commits into
flutter:mainfrom
crackedhandle:remove-legacy-inspector-docs
Closed

Remove legacy inspector documentation#13233
crackedhandle wants to merge 2 commits into
flutter:mainfrom
crackedhandle:remove-legacy-inspector-docs

Conversation

@crackedhandle

@crackedhandle crackedhandle commented Mar 30, 2026

Copy link
Copy Markdown

Fixes flutter/devtools#9567

Changes

  • Deleted src/content/tools/devtools/legacy-inspector.md
  • Removed the "Use legacy inspector" settings section from inspector.md
  • Removed the legacy inspector entry from src/data/sidenav/default.yml

Context

The legacy inspector has been fully replaced by the new inspector,
which is enabled by default since Flutter 3.29. The legacy-inspector
page had a warning banner saying it would be removed in a future release —
this PR removes it now.

The legacy inspector has been replaced by the new inspector
which is enabled by default since Flutter 3.29. This removes:
- The legacy-inspector.md page
- The 'Use legacy inspector' settings section from inspector.md
- The legacy inspector entry from the sidenav

Fixes flutter#9567
@crackedhandle
crackedhandle requested review from a team and sfshaza2 as code owners March 30, 2026 20:12

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request removes the legacy Flutter inspector documentation, its associated section in the main inspector guide, and its entry in the side navigation. Feedback suggests further updating the inspector documentation to remove obsolete references to the "new" inspector and the option to disable it, as these distinctions are no longer necessary following the removal of the legacy version.

However, it can be disabled from the [inspector settings dialog][].

[inspector settings dialog]: #inspector-settings
[legacy inspector]: /tools/devtools/legacy-inspector

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

The removal of the legacy inspector link is correct. However, the introductory text in this section (lines 32-33) still refers to the inspector as "the new Flutter inspector" and mentions that it can be disabled. Since the legacy inspector has been removed, these distinctions are now obsolete and potentially confusing for users.

Consider updating the text to reflect that the current inspector is the standard one and removing the mention of disabling it to switch to the legacy version. For example:

## The Flutter inspector {:#new}

The Flutter inspector is enabled by default. It can be configured from the [inspector settings dialog][].

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

medium

The removal of the legacy inspector link is correct. However, the introductory text in this section (lines 32-33) still refers to the inspector as "the new Flutter inspector" and mentions that it can be disabled. Since the legacy inspector has been removed, these distinctions are now obsolete and potentially confusing for users.

Consider updating the text to reflect that the current inspector is the standard one and removing the mention of disabling it to switch to the legacy version. For example:

## The Flutter inspector {:#new}

The Flutter inspector is enabled by default. It can be configured from the [inspector settings dialog][].

Fixed, updated the heading and intro text to remove the 'new' distinction and the mention of disabling to switch to legacy inspector.

Since the legacy inspector has been removed, references to
'the new Flutter inspector' and the option to disable it
are now obsolete. Updated heading and intro text accordingly.
@elliette

Copy link
Copy Markdown
Member

Hi @crackedhandle - thank you for your contribution! However, we don't want to remove the documentation about the legacy inspector until after it has been removed from DevTools. Therefore I'm going to go ahead and close this.

@elliette elliette closed this Mar 30, 2026
@crackedhandle

Copy link
Copy Markdown
Author

Thanks for the clarification @elliette! That makes complete sense -
I'll wait for the legacy inspector to be removed from DevTools first
and reopen this PR at that point

@srawlins

srawlins commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

@crackedhandle if you are keen on re-opening this, the legacy inspector has been deleted, in flutter/devtools@46811ca, and we can now delete references to it.

@crackedhandle

Copy link
Copy Markdown
Author

Thanks, Samuel! I'd be happy to continue this. I don't seem to have permission to reopen the PR from my side. Could you please reopen it? I'll update it as needed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Remove documentation about the legacy inspector from the Flutter website

3 participants