Docs: 2.5.0 CM/MEC leftovers for #5630 (#5658)

Point v1 ConfigurationManager users at TuiConfigurationBuilder, add a
2.5.0 breaking-changes conceptual page, align the README develop
increment with GitVersion.yml Patch, and correct Schemes.Resolve to
SchemeManager.GetScheme in the primer and llms.txt.

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

Author: tig

Terminal.Gui/README.md

@@ -14,10 +14,12 @@ The [GitVersion.MsBuild](https://www.nuget.org/packages/GitVersion.MsBuild) NuGe
 |--------|----------------|-----------|-------|
 | `main` (stable) | `2.0.0` | Patch | Label set in `GitVersion.yml` (`label: ''`) |
 | `main` (pre-release) | `2.0.1-rc.1` | Patch | Label set in `GitVersion.yml` (e.g., `label: rc`) |
-| `develop` | `2.1.0-develop.42` | Minor | Always carries `-develop` pre-release label |
-| `feature/*`, `fix/*`, etc. | `2.1.0-my-feature.1` | Inherit | Inherits from `develop`; branch name becomes label |
+| `develop` | `2.5.0-develop.55` | Patch | Always carries `-develop` pre-release label |
+| `feature/*`, `fix/*`, etc. | `2.5.0-my-feature.1` | Inherit | Inherits from `develop`; branch name becomes label |
 | `pull-request/*` | `2.0.0-pr.123.1` | Inherit | PR number in label |
 
+`develop` increments **Patch** (`GitVersion.yml` `increment: Patch`). To bump Minor, include `+semver: minor` in a commit message. Do not pin `next-version`.
+
 ### Checking Versions Locally
 
 ```powershell
@@ -135,7 +137,7 @@ These branches are **not** configured in `GitVersion.yml` (the config was remove
 
 - **Package**: [nuget.org/packages/Terminal.Gui](https://www.nuget.org/packages/Terminal.Gui)
 - **Auto-published** on every push to `develop` (pre-release versions) and on `v*` tag pushes (stable/pre-release versions tagged on `main`)
-- Pre-release versions (e.g., `2.1.0-develop.42`) are marked as pre-release on NuGet
+- Pre-release versions (e.g., `2.5.0-develop.55`) are marked as pre-release on NuGet
 
 ### Local Package Development
 

ai-v2-primer.md

@@ -37,7 +37,7 @@ most of what you "know" about Terminal.Gui is **wrong**. The API has fundamental
 | `view.Bounds` | `view.Viewport` |
 | `LayoutStyle.Computed` | Removed — all layout is declarative via `Pos`/`Dim` |
 | `new RadioGroup (...)` | `new OptionSelector { ... }` |
-| `Colors.ColorSchemes ["name"]` | `Schemes.Resolve ("name")` or use `Scheme` directly |
+| `Colors.ColorSchemes ["name"]` | `SchemeManager.GetScheme ("name")` or use `Scheme` directly |
 | `Application.RequestStop ()` | `App!.RequestStop ()` (from inside a `Runnable`) |
 | `Pos.At (n)` / `Pos.Left (v)` | Assign integers directly: `X = 5;` (implicit conversion) |
 

docfx/docs/breaking-changes-2.5.0.md

@@ -0,0 +1,35 @@
+# Terminal.Gui 2.5.0 Breaking Changes
+
+Terminal.Gui 2.5.0 is a minor bump that includes planned API breaks. Apps that compiled against 2.4.17 may need source changes.
+
+The GitHub Release notes list for this train lives on [#5630](https://github.com/tui-cs/Terminal.Gui/issues/5630). This page covers the four breaks that belong in the conceptual docs.
+
+## `View.Text` is no longer virtual
+
+<xref:Terminal.Gui.ViewBase.View.Text> is a non-virtual property. To validate or cancel a change, override `OnTextChanging(string)` or subscribe to <xref:Terminal.Gui.ViewBase.View.TextChanging>. To react after a change, override `OnTextChanged` or subscribe to <xref:Terminal.Gui.ViewBase.View.TextChanged>.
+
+`TextField` uses `View.Text` directly (no `new` hider).
+
+See [Cancellable Work Pattern](cancellable-work-pattern.md) and [Events](events.md).
+
+## `IAcceptTarget` moved to `Terminal.Gui.Input`
+
+<xref:Terminal.Gui.Input.IAcceptTarget> now lives in `Terminal.Gui.Input`. To compile against 2.5.0, add `using Terminal.Gui.Input;`.
+
+See [Command](command.md).
+
+## `ConfigurationManager` and `[ConfigurationProperty]` removed
+
+2.5.0 deletes the legacy `ConfigurationManager` type and the `[ConfigurationProperty]` attribute that 2.4.17 marked `[Obsolete]`.
+
+To load themes and settings, use <xref:Terminal.Gui.Configuration.TuiConfigurationBuilder> and Settings POCOs such as `ButtonSettings.Current`.
+
+See [Configuration](config.md) and [Migrating ConfigurationManager to TuiConfigurationBuilder](migrate-cm-to-mec.md).
+
+## `config.json` is nested only
+
+A pre-2.5.0 file with dotted keys (`"Button.DefaultShadow"`) or array-shaped `Themes` / `Schemes` is not applied. A `WARN` log names the file.
+
+To convert a legacy file, run `Tools/MigrateConfig`. Nested JSON is the supported contract.
+
+See [Configuration](config.md) and [Migrating ConfigurationManager to TuiConfigurationBuilder](migrate-cm-to-mec.md).

docfx/docs/config.md

@@ -2,7 +2,7 @@
 
 Terminal.Gui loads themes, glyphs, key bindings, and view defaults from JSON using [Microsoft.Extensions.Configuration](https://learn.microsoft.com/dotnet/core/extensions/configuration) via <xref:Terminal.Gui.Configuration.TuiConfigurationBuilder>.
 
-The legacy `ConfigurationManager` type was removed in 2.5.0. To convert a pre-2.5.0 `config.json`, see [Migrating ConfigurationManager to TuiConfigurationBuilder](migrate-cm-to-mec.md).
+The legacy `ConfigurationManager` type was removed in 2.5.0. To convert a pre-2.5.0 `config.json`, see [Migrating ConfigurationManager to TuiConfigurationBuilder](migrate-cm-to-mec.md). For the other 2.5.0 API breaks, see [2.5.0 Breaking Changes](breaking-changes-2.5.0.md).
 
 ## Quick start
 
@@ -150,6 +150,7 @@ IConfiguration config = new ConfigurationBuilder ()
 
 ## See also
 
+- [2.5.0 Breaking Changes](breaking-changes-2.5.0.md)
 - [Migrating ConfigurationManager to TuiConfigurationBuilder](migrate-cm-to-mec.md)
 - [Configuration JSON Schema](../schemas/tui-config-schema.json)
 - [Scheme Deep Dive](scheme.md)

docfx/docs/index.md

@@ -12,6 +12,7 @@ Welcome to the Terminal.Gui documentation! This comprehensive guide covers every
 - [Getting Started](~/docs/getting-started.md) - Quick start guide to create your first Terminal.Gui application
 - [Migrating from v1 to v2](~/docs/migratingfromv1.md) - Complete guide for upgrading existing applications
 - [What's New in v2](~/docs/newinv2.md) - Overview of new features and improvements
+- [2.5.0 Breaking Changes](~/docs/breaking-changes-2.5.0.md) - `View.Text` CWP, `IAcceptTarget` namespace, `ConfigurationManager` removal, nested `config.json`
 - [Showcase](~/docs/showcase.md) - Showcase of TUI apps built with Terminal.Gui
 - [Lexicon & Taxonomy](~/docs/lexicon.md) - Terminology and concepts used throughout Terminal.Gui
 - [Views](~/docs/views.md) - Comprehensive list of built-in views and controls

docfx/docs/migratingfromv1.md

@@ -8,6 +8,7 @@ For detailed breaking change documentation, check out this Discussion: https://g
 
 - [Overview of Major Changes](#overview-of-major-changes)
 - [Application Architecture](#application-architecture)
+- [Configuration](#configuration)
 - [View Construction and Initialization](#view-construction-and-initialization)
 - [Layout System Changes](#layout-system-changes)
 - [Color and Attribute Changes](#color-and-attribute-changes)
@@ -166,6 +167,16 @@ public class MyView : View
 
 ---
 
+## Configuration
+
+v1 exposed `ConfigurationManager` (typically `ConfigurationManager.Enable`). That API is gone in 2.5.0.
+
+To load themes and settings in v2, use <xref:Terminal.Gui.Configuration.TuiConfigurationBuilder> and Settings POCOs. Do not call `ConfigurationManager.Enable`.
+
+To convert a pre-2.5.0 `config.json`, see [Migrating ConfigurationManager to TuiConfigurationBuilder](migrate-cm-to-mec.md). For the other 2.5.0 API breaks, see [2.5.0 Breaking Changes](breaking-changes-2.5.0.md).
+
+---
+
 ## View Construction and Initialization
 
 ### Constructors → Initializers
@@ -1093,6 +1104,9 @@ While migration requires some effort, the result is a more robust, performant, a
 
 For more details, see:
 - [Application Deep Dive](application.md)
+- [Configuration Deep Dive](config.md)
+- [Migrating ConfigurationManager to TuiConfigurationBuilder](migrate-cm-to-mec.md)
+- [2.5.0 Breaking Changes](breaking-changes-2.5.0.md)
 - [Keyboard Deep Dive](keyboard.md)
 - [Mouse Deep Dive](mouse.md)
 - [Layout Deep Dive](layout.md)

docfx/docs/newinv2.md

@@ -4,6 +4,8 @@ This document provides an in-depth overview of the new features, improvements, a
 
 **For migration guidance**, see the [v1 To v2 Migration Guide](migratingfromv1.md).
 
+For the 2.5.0 API breaks (`View.Text`, `IAcceptTarget`, `ConfigurationManager`, nested `config.json`), see [2.5.0 Breaking Changes](breaking-changes-2.5.0.md).
+
 ## Table of Contents
 
 - [Overview](#overview)
@@ -656,7 +658,7 @@ builder.ApplyToStaticFacades ();
 builder.ThemeManager.SwitchTheme ("Dark");
 ```
 
-See [Migrating ConfigurationManager to TuiConfigurationBuilder](migrate-cm-to-mec.md) if you still have 2.4.x `ConfigurationManager` calls or a flat-key `config.json`.
+See [Migrating ConfigurationManager to TuiConfigurationBuilder](migrate-cm-to-mec.md) if you still have 2.4.x `ConfigurationManager` calls or a flat-key `config.json`. See [2.5.0 Breaking Changes](breaking-changes-2.5.0.md) for the other 2.5.0 API breaks.
 
 **User Customization:**
 - End-users can personalize themes, colors, text styles

docfx/docs/toc.yml

@@ -7,7 +7,9 @@
 - name: What's new in v2
   href: newinv2.md
 - name: v1 To v2 Migration
-  href: migratingfromv1.md  
+  href: migratingfromv1.md
+- name: 2.5.0 Breaking Changes
+  href: breaking-changes-2.5.0.md
 - name: Lexicon & Taxonomy
   href: lexicon.md
 - name: Views

llms.txt

@@ -27,7 +27,7 @@
 | `view.Bounds` | `view.Viewport` |
 | `LayoutStyle.Computed` | Removed — all layout is declarative via `Pos`/`Dim` |
 | `new RadioGroup (...)` | `new OptionSelector { ... }` |
-| `Colors.ColorSchemes ["name"]` | `Schemes.Resolve ("name")` or use `Scheme` directly |
+| `Colors.ColorSchemes ["name"]` | `SchemeManager.GetScheme ("name")` or use `Scheme` directly |
 | `Application.RequestStop ()` | `App!.RequestStop ()` (from inside a `Runnable`) |
 
 > **Full v1→v2 corrections**: See [ai-v2-primer.md](ai-v2-primer.md)