From 90e8e0b42b872e1088e0b8fc080919e78cfbaf05 Mon Sep 17 00:00:00 2001
From: Vinicius Goulart <vinicius.goulart@camunda.com>
Date: Thu, 12 Dec 2024 21:43:03 +0100
Subject: [PATCH] fix: fix document preview properties panel text

---
 .../entries/DocumentsDataSource.js                 |  2 +-
 .../properties-panel/entries/EndpointKey.js        | 14 +++++---------
 .../properties-panel/PropertiesPanel.spec.js       |  2 +-
 3 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/packages/form-js-editor/src/features/properties-panel/entries/DocumentsDataSource.js b/packages/form-js-editor/src/features/properties-panel/entries/DocumentsDataSource.js
index 0b7e322a2..c7601d8c0 100644
--- a/packages/form-js-editor/src/features/properties-panel/entries/DocumentsDataSource.js
+++ b/packages/form-js-editor/src/features/properties-panel/entries/DocumentsDataSource.js
@@ -64,7 +64,7 @@ function DocumentsDataSource(props) {
     element: field,
     getValue,
     id,
-    label: 'Documents metadata source',
+    label: 'Document reference',
     feel: 'required',
     singleLine: true,
     setValue,
diff --git a/packages/form-js-editor/src/features/properties-panel/entries/EndpointKey.js b/packages/form-js-editor/src/features/properties-panel/entries/EndpointKey.js
index f25b32147..62e7334bf 100644
--- a/packages/form-js-editor/src/features/properties-panel/entries/EndpointKey.js
+++ b/packages/form-js-editor/src/features/properties-panel/entries/EndpointKey.js
@@ -40,21 +40,17 @@ function EndpointKey(props) {
 
   const tooltip = (
     <div>
-      <p>A context key that will be evaluated to a string containing the API endpoint for downloading a document.</p>
+      <p>Enter a context key that generates a string with the API endpoint to download a document.</p>
       <p>
-        This string must contain <br />
-        the <code>{'{ documentId }'}</code> placeholder which will be replaced with the document ID from the documents
-        metadata.
+        The string must contain <code>{'{ documentId }'}</code>, which will be replaced with the document ID from the
+        document's reference.
       </p>
+      <p>If you're using the Camunda Tasklist, this variable is automatically added to the context for you.</p>
       <p>
-        If you're using the Camunda Tasklist UI this variable will be automatically injected in the context for you.
-      </p>
-      <p>
-        Find more details in the{' '}
+        For more details, see the{' '}
         <a href="https://docs.camunda.io" rel="noopener noreferrer" target="_blank">
           Camunda documentation
         </a>
-        .
       </p>
     </div>
   );
diff --git a/packages/form-js-editor/test/spec/features/properties-panel/PropertiesPanel.spec.js b/packages/form-js-editor/test/spec/features/properties-panel/PropertiesPanel.spec.js
index bd1cfa900..5a8e9d463 100644
--- a/packages/form-js-editor/test/spec/features/properties-panel/PropertiesPanel.spec.js
+++ b/packages/form-js-editor/test/spec/features/properties-panel/PropertiesPanel.spec.js
@@ -3449,7 +3449,7 @@ describe('properties panel', function () {
 
         // then
         expectPanelStructure(container, {
-          General: ['Title', 'Documents metadata source'],
+          General: ['Title', 'Document reference'],
           'Download settings': ['Document URL'],
           Condition: [],
           Appearance: ['Max height of preview container'],