From 61d5d63bf9bc041707023a4720bed3ec4b2069b3 Mon Sep 17 00:00:00 2001
From: marhali <me@marhali.de>
Date: Wed, 24 Aug 2022 20:48:55 +0200
Subject: [PATCH] increase visibility for the docs provider

---
 .../documentation/AbstractDocumentationProvider.java | 12 ++++++++----
 src/main/resources/messages.properties               |  2 +-
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/main/java/de/marhali/easyi18n/assistance/documentation/AbstractDocumentationProvider.java b/src/main/java/de/marhali/easyi18n/assistance/documentation/AbstractDocumentationProvider.java
index a2a1d10..c968481 100644
--- a/src/main/java/de/marhali/easyi18n/assistance/documentation/AbstractDocumentationProvider.java
+++ b/src/main/java/de/marhali/easyi18n/assistance/documentation/AbstractDocumentationProvider.java
@@ -16,6 +16,7 @@ import de.marhali.easyi18n.util.KeyPathConverter;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import java.text.MessageFormat;
 import java.util.LinkedHashMap;
 import java.util.Map;
 import java.util.ResourceBundle;
@@ -76,10 +77,6 @@ abstract class AbstractDocumentationProvider implements DocumentationProvider, O
 
         StringBuilder builder = new StringBuilder();
 
-        builder.append(DocumentationMarkup.DEFINITION_START);
-        builder.append(bundle.getString("documentation"));
-        builder.append(DocumentationMarkup.DEFINITION_END);
-
         if(results.size() == 1) { // Single value
             builder.append(DocumentationMarkup.CONTENT_START);
             builder.append("<strong>").append(results.values().toArray()[0]).append("</strong>");
@@ -99,6 +96,13 @@ abstract class AbstractDocumentationProvider implements DocumentationProvider, O
             builder.append(DocumentationMarkup.SECTIONS_END);
         }
 
+        String excerpt = MessageFormat.format(bundle.getString("documentation"),
+                "<strong>'" + settings.getPreviewLocale() + "'</strong>");
+
+        builder.append(DocumentationMarkup.CONTENT_START).append(DocumentationMarkup.GRAYED_START);
+        builder.append(excerpt);
+        builder.append(DocumentationMarkup.GRAYED_END).append(DocumentationMarkup.CONTENT_END);
+
         return  builder.toString();
     }
 }
diff --git a/src/main/resources/messages.properties b/src/main/resources/messages.properties
index 03cdc40..40ec0c2 100644
--- a/src/main/resources/messages.properties
+++ b/src/main/resources/messages.properties
@@ -1,4 +1,4 @@
-documentation=EasyI18n Translation
+documentation=Excerpt from the {0} translations
 view.tree.title=Tree View
 view.tree.collapse=Collapse Tree
 view.tree.expand=Expand Tree