From 7052bf3781019f2023d636bd1171786976dcbd38 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?H=C3=A9ctor=20Ram=C3=B3n=20Jim=C3=A9nez?= <hector@hecrj.dev>
Date: Thu, 20 Nov 2025 01:50:17 +0100
Subject: [PATCH] Improve consistency of `runtime::window` documentation

---
 runtime/src/window.rs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/runtime/src/window.rs b/runtime/src/window.rs
index bcebc631..2a05a96d 100644
--- a/runtime/src/window.rs
+++ b/runtime/src/window.rs
@@ -16,7 +16,7 @@ use raw_window_handle::{HasDisplayHandle, HasWindowHandle};
 
 /// An operation to be performed on some window.
 pub enum Action {
-    /// Opens a new window with some [`Settings`].
+    /// Open a new window with some [`Settings`].
     Open(Id, Settings, oneshot::Sender<Id>),
 
     /// Close the window and exits the application.
@@ -151,7 +151,7 @@ pub enum Action {
     /// Screenshot the viewport of the window.
     Screenshot(Id, oneshot::Sender<Screenshot>),
 
-    /// Enables mouse passthrough for the given window.
+    /// Enable mouse passthrough for the given window.
     ///
     /// This disables mouse events for the window and passes mouse events
     /// through to whatever window is underneath.
@@ -175,13 +175,13 @@ pub enum Action {
     /// Set the window size increment.
     SetResizeIncrements(Id, Option<Size>),
 
-    /// Get the size of the monitor on which the window currently resides in logical dimensions.
+    /// Get the logical dimensions of the monitor containing the window with the given [`Id`].
     GetMonitorSize(Id, oneshot::Sender<Option<Size>>),
 
-    /// Redraws all the windows.
+    /// Redraw all the windows.
     RedrawAll,
 
-    /// Recomputes the layouts of all the windows.
+    /// Recompute the layouts of all the windows.
     RelayoutAll,
 }
 
@@ -495,7 +495,7 @@ pub fn disable_mouse_passthrough<Message>(id: Id) -> Task<Message> {
     task::effect(crate::Action::Window(Action::DisableMousePassthrough(id)))
 }
 
-/// Get the size of the monitor on which the window currently resides in logical dimensions.
+/// Get the logical dimensions of the monitor containing the window with the given [`Id`].
 pub fn monitor_size(id: Id) -> Task<Option<Size>> {
     task::oneshot(move |channel| {
         crate::Action::Window(Action::GetMonitorSize(id, channel))