diff --git a/topics/user_interface_components/tool_windows.md b/topics/user_interface_components/tool_windows.md
index 6492e9b13..c1ead48d9 100644
--- a/topics/user_interface_components/tool_windows.md
+++ b/topics/user_interface_components/tool_windows.md
@@ -52,7 +52,7 @@ If the tool window of a plugin should not be displayed for all projects:
-Implement `ToolWindowFactory.isApplicableAsync(Project)`.
+Implement suspending `ToolWindowFactory.isApplicableAsync(Project)` in Kotlin.
@@ -70,7 +70,8 @@ Specify the `conditionClass` attribute in plugin.xml with a class i
-Note, the condition is evaluated only once when the project is loaded.
+> The condition is evaluated only once when the project is loaded.
+
To show and hide a tool window dynamically while the user is working with the project, use [programmatic setup](#programmatic-setup) for tool window registration.
### Programmatic Setup