From 509d743abf71a699b60a892f3b59ad555bbe0fa3 Mon Sep 17 00:00:00 2001
From: Rune Flobakk <rune.flobakk@posten.no>
Date: Tue, 10 Oct 2023 16:30:11 +0200
Subject: [PATCH 1/4] Upgrade Maven plugins

---
 lib/pom.xml | 6 +++---
 pom.xml     | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/pom.xml b/lib/pom.xml
index 863fbefc..feadfb90 100644
--- a/lib/pom.xml
+++ b/lib/pom.xml
@@ -188,7 +188,7 @@
                 <plugin>
                     <groupId>com.github.siom79.japicmp</groupId>
                     <artifactId>japicmp-maven-plugin</artifactId>
-                    <version>0.17.3</version>
+                    <version>0.18.1</version>
                     <configuration>
                         <parameter>
                             <includes>
@@ -202,7 +202,7 @@
                 </plugin>
                 <plugin>
                     <artifactId>maven-shade-plugin</artifactId>
-                    <version>3.5.0</version>
+                    <version>3.5.1</version>
                     <configuration>
                         <minimizeJar>true</minimizeJar>
                         <artifactSet>
@@ -236,7 +236,7 @@
                 </plugin>
                 <plugin>
                     <artifactId>maven-javadoc-plugin</artifactId>
-                    <version>3.5.0</version>
+                    <version>3.6.0</version>
                 </plugin>
                 <plugin>
                     <artifactId>maven-jar-plugin</artifactId>
diff --git a/pom.xml b/pom.xml
index 84646d05..eea5558e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -77,7 +77,7 @@
                 <plugin>
                     <groupId>org.codehaus.mojo</groupId>
                     <artifactId>versions-maven-plugin</artifactId>
-                    <version>2.16.0</version>
+                    <version>2.16.1</version>
                 </plugin>
             </plugins>
         </pluginManagement>

From fb8d73e7ed2fa40a871467f97f725cc6b1f4c91f Mon Sep 17 00:00:00 2001
From: Rune Flobakk <rune.flobakk@posten.no>
Date: Tue, 10 Oct 2023 16:31:01 +0200
Subject: [PATCH 2/4] Remove unnecessary reference to internal docs

---
 README.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/README.md b/README.md
index d0bb2c93..0d25600a 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,3 @@ This repo is the Java client library for integrating with Posten signering. Plea
 ## 📕 Documentation
 
 Get started by [reading the documentation](http://signering-docs.rtfd.io/).
- 
-## Releasing (only for Digipost members)
-
-See docs/systemer/open-source-biblioteker.md

From eedab44264ae87bb8ab3987aae98fefb236053ef Mon Sep 17 00:00:00 2001
From: Rune Flobakk <rune.flobakk@posten.no>
Date: Tue, 10 Oct 2023 16:34:15 +0200
Subject: [PATCH 3/4] Add javadoc badge

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 0d25600a..8bcce685 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,6 @@
 # Posten Signering – Java client Library
 [![Maven Central](https://maven-badges.herokuapp.com/maven-central/no.digipost.signature/signature-api-client-java/badge.svg)](https://maven-badges.herokuapp.com/maven-central/no.digipost.signature/signature-api-client-java)
+[![javadoc](https://javadoc.io/badge2/no.digipost.signature/signature-api-client-java/javadoc.svg?logo=java&color=yellow)](https://javadoc.io/doc/no.digipost.signature/signature-api-client-java)
 ![](https://github.com/digipost/signature-api-client-java/workflows/Build%20and%20deploy/badge.svg)
 [![License](https://img.shields.io/badge/license-Apache%202-blue)](https://github.com/digipost/signature-api-client-java/blob/main/LICENCE)
 

From 56242b68bed7d1abffc4ad7ee901d82f85c8a0df Mon Sep 17 00:00:00 2001
From: Rune Flobakk <rune.flobakk@posten.no>
Date: Tue, 10 Oct 2023 16:41:42 +0200
Subject: [PATCH 4/4] Add recommended Maven dependency declaration

---
 README.md | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 8bcce685..78e12955 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,38 @@
 ![](https://github.com/digipost/signature-api-client-java/workflows/Build%20and%20deploy/badge.svg)
 [![License](https://img.shields.io/badge/license-Apache%202-blue)](https://github.com/digipost/signature-api-client-java/blob/main/LICENCE)
 
-This repo is the Java client library for integrating with Posten signering. Please see [signature-api-client-dotnet](https://github.com/digipost/signature-api-client-dotnet) for the C# version.
+This repo is the Java client library for integrating with **Posten signering**.
 
-## 📕 Documentation
+If you are looking for the C# variant of this library, please see [signature-api-client-dotnet](https://github.com/digipost/signature-api-client-dotnet).
+
+## Documentation
 
 Get started by [reading the documentation](http://signering-docs.rtfd.io/).
+
+
+## Dependency
+
+The recommended way to declare dependency on the library is to utilize the [BOM](https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#bill-of-materials-bom-poms). With Maven, this is declared like this:
+
+```xml
+<dependencyManagement>
+    <dependencies>
+        <dependency>
+            <groupId>no.digipost.signature</groupId>
+            <artifactId>signature-api-client-bom</artifactId>
+            <version>7.0.1</version> <!-- replace with any later version -->
+            <type>pom</type>
+            <scope>import</scope>
+        </dependency>
+...
+```
+
+And depend directly on the library artifact (without any specified version, since this is supplied by the BOM artifact above)
+```xml
+<dependencies>
+    <dependency>
+        <groupId>no.digipost.signature</groupId>
+        <artifactId>signature-api-client-java</artifactId>
+    </dependency>
+...
+```