From e3481a0330f1cbefb740de7eb2b1627aab930f69 Mon Sep 17 00:00:00 2001
From: Richard Eckart de Castilho <richard.eckart@gmail.com>
Date: Fri, 5 Jan 2024 13:20:50 +0100
Subject: [PATCH] #4428 - Slow knowledge-base lookups on relation layers

- Small layout fix in the concept feature traits editor
- Improve documentation for the meaning of root concepts
---
 .../ui/kb/feature/ConceptFeatureTraitsEditor.html        | 2 +-
 .../asciidoc/user-guide/projects_knowledge-base.adoc     | 9 ++++++++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/inception/inception-ui-kb/src/main/java/de/tudarmstadt/ukp/inception/ui/kb/feature/ConceptFeatureTraitsEditor.html b/inception/inception-ui-kb/src/main/java/de/tudarmstadt/ukp/inception/ui/kb/feature/ConceptFeatureTraitsEditor.html
index 80c1d3fbb89..cbbdaaca471 100644
--- a/inception/inception-ui-kb/src/main/java/de/tudarmstadt/ukp/inception/ui/kb/feature/ConceptFeatureTraitsEditor.html
+++ b/inception/inception-ui-kb/src/main/java/de/tudarmstadt/ukp/inception/ui/kb/feature/ConceptFeatureTraitsEditor.html
@@ -41,7 +41,7 @@
         <wicket:label key="scope"/>
       </label>
       <div class="col-sm-8">
-        <input wicket:id="scope" class="form-control w-100"/>
+        <input wicket:id="scope" class="w-100"/>
       </div>
     </div>
   </form>
diff --git a/inception/inception-ui-kb/src/main/resources/META-INF/asciidoc/user-guide/projects_knowledge-base.adoc b/inception/inception-ui-kb/src/main/resources/META-INF/asciidoc/user-guide/projects_knowledge-base.adoc
index 923df966308..dcbdd2aa6bc 100644
--- a/inception/inception-ui-kb/src/main/resources/META-INF/asciidoc/user-guide/projects_knowledge-base.adoc
+++ b/inception/inception-ui-kb/src/main/resources/META-INF/asciidoc/user-guide/projects_knowledge-base.adoc
@@ -225,7 +225,14 @@ user can choose one of the pre-configured mapping or provide a custom mapping.
 
 === Root Concepts
 
-In the advanced settings, the user can leverage this feature of KB settings when one doesn't want the entire knowledge base to be used and rather choose to identify some specific root concepts. This feature specially helps in case of large knowledge bases such as Wikidata.
+The knowledge base browser displays a class tree. By default, it tries to automatically determine the root classes of
+this tree. However, for very large KBs this can be slow. Also you might not be interested in browsing the entire KB
+but would rather focus on specific subtrees. In such cases, you can define the root concepts explicitly here.
+
+NOTE: This setting currently affects **only class tree in the knowledge base browser**. You can still search for concepts
+      that are outside of the subtrees induced by the root concepts using the search field on the knowledge-base page and you
+      can also still link concept features. to concepts outside the subtrees. In order to limit a concept feature to a particular
+      subtree, use the **Scope** setting in the <<sect_concept_features,concept feature settings>>.
 
 
 === Additional Matching Properties