Browse Source

Update terminology proposal to reflect recent modernization (post-MainLoop removal)

Co-authored-by: tig <[email protected]>
copilot-swe-agent[bot] 1 month ago
parent
commit
901d0814c3

+ 2 - 0
docfx/docs/terminology-index.md

@@ -1,5 +1,7 @@
 # Terminal.Gui Terminology Proposal - Documentation Index
 # Terminal.Gui Terminology Proposal - Documentation Index
 
 
+> **Updated October 2025**: Proposal validated and updated to reflect recent architectural modernizations, including removal of legacy MainLoop infrastructure.
+
 This directory contains a comprehensive proposal for renaming `Application.Top` and related terminology in Terminal.Gui v2.
 This directory contains a comprehensive proposal for renaming `Application.Top` and related terminology in Terminal.Gui v2.
 
 
 ## 📚 Documents
 ## 📚 Documents

+ 2 - 0
docfx/docs/terminology-proposal-summary.md

@@ -1,5 +1,7 @@
 # Terminology Proposal Summary
 # Terminology Proposal Summary
 
 
+> **Updated October 2025**: Proposal validated against current modernized codebase (post-MainLoop removal).
+
 This is a brief summary of the [full terminology proposal](terminology-proposal.md).
 This is a brief summary of the [full terminology proposal](terminology-proposal.md).
 
 
 ## Recommended Changes
 ## Recommended Changes

+ 7 - 3
docfx/docs/terminology-proposal.md

@@ -1,5 +1,7 @@
 # Terminology Proposal: Renaming Application.Top and Toplevel
 # Terminology Proposal: Renaming Application.Top and Toplevel
 
 
+> **Note**: This proposal has been updated (October 2025) to reflect recent architectural improvements in Terminal.Gui v2, including the removal of legacy MainLoop infrastructure and modernization of the application event loop. The proposal remains valid and relevant with the current codebase.
+
 ## Executive Summary
 ## Executive Summary
 
 
 This document proposes new, clearer terminology to replace the confusing `Application.Top` and `Toplevel` naming in Terminal.Gui v2. The goal is to establish intuitive names that accurately represent the concepts while maintaining backward compatibility during migration.
 This document proposes new, clearer terminology to replace the confusing `Application.Top` and `Toplevel` naming in Terminal.Gui v2. The goal is to establish intuitive names that accurately represent the concepts while maintaining backward compatibility during migration.
@@ -15,12 +17,14 @@ This document proposes new, clearer terminology to replace the confusing `Applic
 
 
 ### Current Usage Patterns
 ### Current Usage Patterns
 
 
-Based on code analysis:
-- `Application.Top` - The currently active/running view with its own event loop
-- `Application.TopLevels` - Internal stack of all active "runnable" views
+Based on current code analysis (as of October 2025):
+- `Application.Top` - The currently active/running view with its own run loop
+- `Application.TopLevels` - Internal stack of all active "runnable" views  
 - `Toplevel` class - Base class for views that can run independently (Window, Dialog, etc.)
 - `Toplevel` class - Base class for views that can run independently (Window, Dialog, etc.)
 - Modal vs Non-modal - Views that can be "run" either as overlays or embedded
 - Modal vs Non-modal - Views that can be "run" either as overlays or embedded
 
 
+**Recent Modernization**: Terminal.Gui v2 has completed modernization of its application infrastructure, removing legacy MainLoop code and consolidating around `ApplicationImpl.Coordinator` for event loop management. The terminology confusion addressed in this proposal remains relevant to the current codebase.
+
 ## Proposed Terminology
 ## Proposed Terminology
 
 
 ### 1. Application.Top → Application.Current
 ### 1. Application.Top → Application.Current