diff --git a/src/serena/repl/api/jb_api.py b/src/serena/repl/api/jb_api.py
index 92728bdb..5cf8fc27 100644
--- a/src/serena/repl/api/jb_api.py
+++ b/src/serena/repl/api/jb_api.py
@@ -399,7 +399,7 @@ class JetBrainsApi(FacadeApi):
     @facade_method(corresponding_tool=JetBrainsFindDeclarationTool)
     def find_declaration(self, relative_path: str, regex: str, include_body: bool = False) -> JetBrainsSymbolCollection:
         r"""
-        Finds the declaration of a symbol.
+        Finds the declaration of a symbol based on an occurrence of the symbol in a source file, specified by a regex.
 
         :param relative_path: the relative path to the source file containing the symbol for which to find the declaration.
         :param regex: a regular expression with one group, where the group matches the symbol for which to perform the lookup.
diff --git a/src/serena/repl/api/lsp_api.py b/src/serena/repl/api/lsp_api.py
index 675f7826..8b86bff7 100644
--- a/src/serena/repl/api/lsp_api.py
+++ b/src/serena/repl/api/lsp_api.py
@@ -609,7 +609,7 @@ class LspApi(FacadeApi):
         include_info: bool = False,
     ) -> LspSymbol:
         r"""
-        Finds the declaration of a symbol.
+        Finds the declaration of a symbol based on an occurrence of the symbol in a source file, specified by a regex.
 
         :param relative_path: the relative path to the source file containing the symbol for which to find the declaration.
         :param regex: a regular expression with one group, where the group matches the symbol for which to perform the lookup.