From f9bc9d6274ec9d1277313f9bf4f33f9cbcaab6fe Mon Sep 17 00:00:00 2001
From: Sam Spycher <samspycher@users.noreply.github.com>
Date: Thu, 8 May 2025 10:12:27 +0200
Subject: [PATCH 1/2] initial release version

Signed-off-by: Sam Spycher <samspycher@users.noreply.github.com>
---
 parsec-client-java/pom.xml    | 2 +-
 parsec-interface-java/pom.xml | 2 +-
 parsec-jca-java-test/pom.xml  | 2 +-
 parsec-jca-java/pom.xml       | 2 +-
 parsec-protobuf-java/pom.xml  | 2 +-
 parsec-testcontainers/pom.xml | 2 +-
 pom.xml                       | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/parsec-client-java/pom.xml b/parsec-client-java/pom.xml
index 575b132..a617828 100644
--- a/parsec-client-java/pom.xml
+++ b/parsec-client-java/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.parallaxsecond</groupId>
         <artifactId>parsec-java</artifactId>
-        <version>0.1.0-SNAPSHOT</version>
+        <version>0.1.0</version>
     </parent>
     <artifactId>parsec-client-java</artifactId>
     <properties>
diff --git a/parsec-interface-java/pom.xml b/parsec-interface-java/pom.xml
index 013484e..f417aa4 100644
--- a/parsec-interface-java/pom.xml
+++ b/parsec-interface-java/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.parallaxsecond</groupId>
         <artifactId>parsec-java</artifactId>
-        <version>0.1.0-SNAPSHOT</version>
+        <version>0.1.0</version>
     </parent>
     <artifactId>parsec-interface-java</artifactId>
     <properties>
diff --git a/parsec-jca-java-test/pom.xml b/parsec-jca-java-test/pom.xml
index 20f28f6..84f4af6 100644
--- a/parsec-jca-java-test/pom.xml
+++ b/parsec-jca-java-test/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <groupId>org.parallaxsecond</groupId>
         <artifactId>parsec-java</artifactId>
-        <version>0.1.0-SNAPSHOT</version>
+        <version>0.1.0</version>
     </parent>
     <artifactId>parsec-jca-java-test</artifactId>
     <properties>
diff --git a/parsec-jca-java/pom.xml b/parsec-jca-java/pom.xml
index b5d1394..2d95c2f 100644
--- a/parsec-jca-java/pom.xml
+++ b/parsec-jca-java/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.parallaxsecond</groupId>
         <artifactId>parsec-java</artifactId>
-        <version>0.1.0-SNAPSHOT</version>
+        <version>0.1.0</version>
     </parent>
     <artifactId>parsec-jca-java</artifactId>
     <properties>
diff --git a/parsec-protobuf-java/pom.xml b/parsec-protobuf-java/pom.xml
index 8dbcb4b..0a016ea 100644
--- a/parsec-protobuf-java/pom.xml
+++ b/parsec-protobuf-java/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.parallaxsecond</groupId>
         <artifactId>parsec-java</artifactId>
-        <version>0.1.0-SNAPSHOT</version>
+        <version>0.1.0</version>
     </parent>
     <artifactId>parsec-protobuf-java</artifactId>
 
diff --git a/parsec-testcontainers/pom.xml b/parsec-testcontainers/pom.xml
index 8b08443..f2007bc 100644
--- a/parsec-testcontainers/pom.xml
+++ b/parsec-testcontainers/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <groupId>org.parallaxsecond</groupId>
         <artifactId>parsec-java</artifactId>
-        <version>0.1.0-SNAPSHOT</version>
+        <version>0.1.0</version>
         <relativePath>..</relativePath>
     </parent>
     <artifactId>parsec-testcontainers</artifactId>
diff --git a/pom.xml b/pom.xml
index b495881..59b0e03 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,7 +5,7 @@
     <packaging>pom</packaging>
     <groupId>org.parallaxsecond</groupId>
     <artifactId>parsec-java</artifactId>
-    <version>0.1.0-SNAPSHOT</version>
+    <version>0.1.0</version>
     <distributionManagement>
         <repository>
             <id>github</id>            <!-- MUST match the server-id in the workflow -->

From a32ce75aedd3cb32298e775cdd53407e301f8426 Mon Sep 17 00:00:00 2001
From: Sam Spycher <samspycher@users.noreply.github.com>
Date: Thu, 8 May 2025 10:54:03 +0200
Subject: [PATCH 2/2] add usage instructions to readme

Signed-off-by: Sam Spycher <samspycher@users.noreply.github.com>
---
 README.md | 38 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 3876541..1c429e9 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,43 @@ The repository contains the following packages:
 
 # How to use this library
 
-TODO
+To use the Parsec JCA provider in your Maven project, you need to:
+
+1.  **Configure GitHub Packages Repository:**
+    Add the following repository configuration to your project's `pom.xml`. This allows Maven to find and download Parsec Java Client artifacts from GitHub Packages.
+
+    ```xml
+    <project>
+        ...
+        <repositories>
+            <repository>
+                <id>github-parallaxsecond</id>
+                <name>GitHub Parallax Second Apache Maven Packages</name>
+                <url>https://maven.pkg.github.com/parallaxsecond/parsec-client-java</url>
+            </repository>
+        </repositories>
+        ...
+    </project>
+    ```
+
+2.  **Add the Dependency:**
+    Add the `parsec-jca-java` artifact as a dependency in your `pom.xml`:
+
+    ```xml
+    <dependencies>
+        ...
+        <dependency>
+            <groupId>org.parallaxsecond</groupId>
+            <artifactId>parsec-jca-java</artifactId>
+            <version>0.1.0</version> <!-- Replace with the desired version -->
+        </dependency>
+        ...
+    </dependencies>
+    ```
+
+    This will also bring in the necessary transitive dependencies: `parsec-client-java`, `parsec-interface-java`, and `parsec-protobuf-java`. For other JVM build systems, please take the necessary coordinates (`groupId`, `artifactId`, `version`) and adapt to your dependency management syntax. You can find the latest available version on the [project's GitHub Packages page](https://github.com/parallaxsecond/parsec-client-java/packages).
+
+    If you don't want to use the JCA, you can employ this library in a more parsec-idiomatic way by depending directly on `parsec-client-java`. _Note:_ this is not a recommendation either way.
 
 # How to develop the Parsec Java Client