diff --git a/crates/debugger_ui/src/debugger_ui.rs b/crates/debugger_ui/src/debugger_ui.rs
index bd5a7cda4a21a3d3fd0ac132d6ba2e7aace68722..5b860e2bbc1469694ce21830b9a79c9d828d8f21 100644
--- a/crates/debugger_ui/src/debugger_ui.rs
+++ b/crates/debugger_ui/src/debugger_ui.rs
@@ -90,11 +90,10 @@ actions!(
     ]
 );
 
-/// Extends selection down by a specified number of lines.
+/// Set a data breakpoint on the selected variable or memory region.
 #[derive(PartialEq, Clone, Deserialize, Default, JsonSchema, Action)]
 #[action(namespace = debugger)]
 #[serde(deny_unknown_fields)]
-/// Set a data breakpoint on the selected variable or memory region.
 pub struct ToggleDataBreakpoint {
     /// The type of data breakpoint
     /// Read & Write
diff --git a/crates/vim/src/helix.rs b/crates/vim/src/helix.rs
index 526519fd13447e24ffc94fa5ee20c73ff288e239..4602862e0514db64870e5a7fb41c57f073cd4d98 100644
--- a/crates/vim/src/helix.rs
+++ b/crates/vim/src/helix.rs
@@ -53,9 +53,9 @@ actions!(
         HelixSubstitute,
         /// Delete the selection and enter edit mode, without yanking the selection.
         HelixSubstituteNoYank,
-        /// Delete the selection and enter edit mode.
+        /// Select the next match for the current search query.
         HelixSelectNext,
-        /// Delete the selection and enter edit mode, without yanking the selection.
+        /// Select the previous match for the current search query.
         HelixSelectPrevious,
     ]
 );
diff --git a/crates/vim/src/normal.rs b/crates/vim/src/normal.rs
index 27662fc20c28bb983d16d9824aeaaa85e42af975..4437f4dc91f1cb6f0d2009b46d4dfbbc7d6c99e9 100644
--- a/crates/vim/src/normal.rs
+++ b/crates/vim/src/normal.rs
@@ -100,9 +100,9 @@ actions!(
         GoToTab,
         /// Go to previous tab page (with count support).
         GoToPreviousTab,
-        /// Go to tab page (with count support).
+        /// Goes to the previous reference to the symbol under the cursor.
         GoToPreviousReference,
-        /// Go to previous tab page (with count support).
+        /// Goes to the next reference to the symbol under the cursor.
         GoToNextReference,
     ]
 );
diff --git a/crates/vim/src/object.rs b/crates/vim/src/object.rs
index 70785b4e94c4ac9d5544bce315f8d8801be4fe57..f852e24bc37ed1f9276bcfbab8f70777c7a7ea3d 100644
--- a/crates/vim/src/object.rs
+++ b/crates/vim/src/object.rs
@@ -85,7 +85,7 @@ pub struct CandidateWithRanges {
     close_range: Range<MultiBufferOffset>,
 }
 
-/// Selects text at the same indentation level.
+/// Operates on text within or around parentheses `()`.
 #[derive(Clone, Deserialize, JsonSchema, PartialEq, Action)]
 #[action(namespace = vim)]
 #[serde(deny_unknown_fields)]
@@ -94,7 +94,7 @@ struct Parentheses {
     opening: bool,
 }
 
-/// Selects text at the same indentation level.
+/// Operates on text within or around square brackets `[]`.
 #[derive(Clone, Deserialize, JsonSchema, PartialEq, Action)]
 #[action(namespace = vim)]
 #[serde(deny_unknown_fields)]
@@ -103,7 +103,7 @@ struct SquareBrackets {
     opening: bool,
 }
 
-/// Selects text at the same indentation level.
+/// Operates on text within or around angle brackets `<>`.
 #[derive(Clone, Deserialize, JsonSchema, PartialEq, Action)]
 #[action(namespace = vim)]
 #[serde(deny_unknown_fields)]
@@ -111,7 +111,8 @@ struct AngleBrackets {
     #[serde(default)]
     opening: bool,
 }
-/// Selects text at the same indentation level.
+
+/// Operates on text within or around curly brackets `{}`.
 #[derive(Clone, Deserialize, JsonSchema, PartialEq, Action)]
 #[action(namespace = vim)]
 #[serde(deny_unknown_fields)]
diff --git a/crates/zed_actions/src/lib.rs b/crates/zed_actions/src/lib.rs
index 84746cfb03ebf9c86b1d6206175201630005b9e1..d13bfdd2f2e20d8c435009e210c2f2deadfdd038 100644
--- a/crates/zed_actions/src/lib.rs
+++ b/crates/zed_actions/src/lib.rs
@@ -128,7 +128,7 @@ pub struct IncreaseBufferFontSize {
     pub persist: bool,
 }
 
-/// Increases the font size in the editor buffer.
+/// Opens the settings editor at a specific path.
 #[derive(PartialEq, Clone, Debug, Deserialize, JsonSchema, Action)]
 #[action(namespace = zed)]
 #[serde(deny_unknown_fields)]
@@ -512,7 +512,7 @@ pub enum Spawn {
         #[serde(default)]
         reveal_target: Option<RevealTarget>,
     },
-    /// Spawns a task by the name given.
+    /// Spawns a task by the tag given.
     ByTag {
         task_tag: String,
         #[serde(default)]