diff --git a/crates/assistant_tooling/src/tool.rs b/crates/assistant_tooling/src/tool.rs
index 31ed8fdee8f581597ec049d0e5b49ad1211a55b8..3b728e4ba7bef35ffdb46e5aca273ab28abd42e5 100644
--- a/crates/assistant_tooling/src/tool.rs
+++ b/crates/assistant_tooling/src/tool.rs
@@ -70,16 +70,19 @@ pub trait LanguageModelTool {
 
     type View: Render;
 
-    /// The name of the tool is exposed to the language model to allow
-    /// the model to pick which tools to use. As this name is used to
-    /// identify the tool within a tool registry, it should be unique.
+    /// Returns the name of the tool.
+    ///
+    /// This name is exposed to the language model to allow the model to pick
+    /// which tools to use. As this name is used to identify the tool within a
+    /// tool registry, it should be unique.
     fn name(&self) -> String;
 
-    /// A description of the tool that can be used to _prompt_ the model
-    /// as to what the tool does.
+    /// Returns the description of the tool.
+    ///
+    /// This can be used to _prompt_ the model as to what the tool does.
     fn description(&self) -> String;
 
-    /// The OpenAI Function definition for the tool, for direct use with OpenAI's API.
+    /// Returns the OpenAI Function definition for the tool, for direct use with OpenAI's API.
     fn definition(&self) -> ToolFunctionDefinition {
         let root_schema = schema_for!(Self::Input);
 
@@ -90,7 +93,7 @@ pub trait LanguageModelTool {
         }
     }
 
-    /// Execute the tool
+    /// Executes the tool with the given input.
     fn execute(&self, input: &Self::Input, cx: &AppContext) -> Task<Result<Self::Output>>;
 
     fn format(input: &Self::Input, output: &Result<Self::Output>) -> String;