Issue 13619 Make Citation relations text more clear. (#13620)

* Issue 13619 Make Citation relations text more clear.

* Add missing CHANGELOG.md entry.

* Improve javadoc.

* Addressing PR comments

* Addressing PR comments.

* Update jabgui/src/main/java/org/jabref/gui/entryeditor/citationrelationtab/CitationRelationsTab.java

* Fix language file

---------

Co-authored-by: Oliver Kopp <[email protected]>

Author: ankamde

CHANGELOG.md

@@ -26,6 +26,7 @@ Note that this project **does not** adhere to [Semantic Versioning](https://semv
 
 ### Changed
 
+- We changed Citation Relations tab and gave tab panes more descriptive titles and tooltips. [#13619](https://github.com/JabRef/jabref/issues/13619)
 - We changed the name from Open AI Provider to Open AI (or API compatible). [#13585](https://github.com/JabRef/jabref/issues/13585)
 - We improved the citations relations caching by implementing an offline storage. [#11189](https://github.com/JabRef/jabref/issues/11189)
 - We added a tooltip to keywords that resemble Math Subject Classification (MSC) codes. [#12944](https://github.com/JabRef/jabref/issues/12944)

jabgui/src/main/java/org/jabref/gui/entryeditor/citationrelationtab/CitationRelationsTab.java

@@ -149,11 +149,14 @@ private SplitPane getPaneAndStartSearch(BibEntry entry) {
         AnchorPane citedByHBox = new AnchorPane();
         citedByHBox.setPrefHeight(40);
 
-        // Create Heading Lab
-        Label citingLabel = new Label(Localization.lang("Cites"));
-        styleLabel(citingLabel);
-        Label citedByLabel = new Label(Localization.lang("Cited By"));
-        styleLabel(citedByLabel);
+        // Create Headings
+        // See ADR-0047
+        String citationKey = entry.getCitationKey().orElse("this entry");
+
+        Label citingLabel = new Label(Localization.lang("References cited in %0", citationKey));
+        styleLabel(citingLabel, Localization.lang("Also called \"backward citations\""));
+        Label citedByLabel = new Label(Localization.lang("References that cite %0", citationKey));
+        styleLabel(citedByLabel, Localization.lang("Also called \"forward citations\""));
 
         // Create ListViews
         CheckListView<CitationRelationItem> citingListView = new CheckListView<>();
@@ -372,11 +375,13 @@ private void showEntrySourceDialog(BibEntry entry) {
     /**
      * Method to style heading labels
      *
-     * @param label label to style
+     * @param label       label to style
+     * @param tooltipText tooltip text
      */
-    private void styleLabel(Label label) {
+    private void styleLabel(Label label, String tooltipText) {
         label.setStyle("-fx-padding: 5px");
         label.setAlignment(Pos.CENTER);
+        label.setTooltip(new Tooltip(tooltipText));
         AnchorPane.setTopAnchor(label, 0.0);
         AnchorPane.setLeftAnchor(label, 0.0);
         AnchorPane.setBottomAnchor(label, 0.0);

jablib/src/main/resources/l10n/JabRef_en.properties

@@ -2813,13 +2813,15 @@ The\ selected\ entry\ doesn't\ have\ a\ DOI\ linked\ to\ it.=The selected entry
 Look\ up\ a\ DOI\ and\ try\ again.=Look up a DOI and try again.
 Looking\ up\ DOI...=Looking up DOI...
 No\ DOI\ found.=No DOI found.
-Cited\ By=Cited By
-Cites=Cites
+References\ that\ cite\ %0=References that cite %0
+References\ cited\ in\ %0=References cited in %0
 No\ articles\ found=No articles found
 Restart\ search=Restart search
 Cancel\ search=Cancel search
 Select\ entry=Select entry
 Search\ aborted.=Search aborted.
+Also\ called\ "backward\ citations"=Also called "backward citations"
+Also\ called\ "forward\ citations"=Also called "forward citations"
 
 Help\ on\ external\ applications=Help on external applications
 Identifier-based\ Web\ Search=Identifier-based Web Search