OPEN-103: Update README and ReleaseNotes (#43)

Update README and ReleaseNotes with usage instructions and change log

Author: SaBie73

README.md

@@ -44,14 +44,65 @@ without prior notice.**
 
 We aim to support a broad set of operating systems and architectures, including:
 
-| Platform      | Architectures | Runtimes (examples)              | Supported?   |
-|---------------|---------------|----------------------------------|--------------|
-| Linux         | x86_64        | Native Rust, JVM (tests/tooling) | Experimental |
-| Windows       | x86_64        | Native Rust, JVM (tests/tooling) | Experimental |
-| macOS         | arm64         | Native Rust, JVM (tests/tooling) | Experimental |
-| Android       | arm64, x86_64 | JVM (Android, via JNI/NDK)       | Experimental |
-| iOS           | arm64         | Native                           | Experimental |
-| iOS Simulator | arm64         | Native                           | Experimental |
+| Platform      | Architectures | Runtimes (examples)              | Supported? |
+|---------------|---------------|----------------------------------|------------|
+| Linux         | x86_64        | Native Rust, JVM (tests/tooling) | alpha      |
+| Windows       | x86_64        | Native Rust, JVM (tests/tooling) | alpha      |
+| macOS         | arm64         | Native Rust, JVM (tests/tooling) | alpha      |
+| Android       | arm64, x86_64 | JVM (Android, via JNI/NDK)       | alpha      |
+| iOS           | arm64         | Native                           | alpha      |
+alpha
+
+## Usage / Artifacts
+
+Published artifacts are available on Maven Central. Use the latest published version.
+
+Kotlin Multiplatform (common dependency):
+
+```kotlin
+kotlin {
+    sourceSets {
+        val commonMain by getting {
+            dependencies {
+                implementation("de.gematik.openhealth:healthcard:<version>")
+            }
+        }
+    }
+}
+```
+
+Android:
+
+```kotlin
+repositories { mavenCentral() }
+
+dependencies {
+    implementation("de.gematik.openhealth:healthcard-android:<version>")
+}
+```
+
+JVM:
+
+```kotlin
+repositories { mavenCentral() }
+
+dependencies {
+    implementation("de.gematik.openhealth:healthcard-jvm:<version>")
+}
+```
+
+### Swift (Xcode SwiftPM)
+
+1. In Xcode, add a package dependency with the repository URL:
+   `https://github.com/gematik/OpenHealth-Core`.
+2. Set the Dependency Rule to **Exact Version** and pick the desired release tag.
+3. Add the `OpenHealthHealthcard` product to your target.
+
+Notes:
+
+- The Swift package references the xcframework at
+  `core-modules-swift/healthcard/OpenHealthHealthcardFFI.xcframework` inside the selected tag. If that file is missing
+  for a given release, build it locally (see `core-modules-swift/healthcard/README.md`) or use the release asset.
 
 ## Contributing
 

ReleaseNotes.md

@@ -27,6 +27,42 @@ This document summarizes the publicly released versions of OpenHealth Core.
 
 ## Change Log
 
-### LATEST
+### 0.0.1-alpha5 (Latest)
 
-- Initial release.
+Added
+- FFI bindings for healthcard ([#18](https://github.com/gematik/OpenHealth-Core/pull/18)).
+- APDU tools, integration tests, and CV certificate parsing ([#36](https://github.com/gematik/OpenHealth-Core/pull/36), [#35](https://github.com/gematik/OpenHealth-Core/pull/35), [#39](https://github.com/gematik/OpenHealth-Core/pull/39)).
+- Initial OpenSSL build layer and crypto/EC module updates ([#8](https://github.com/gematik/OpenHealth-Core/pull/8), [#12](https://github.com/gematik/OpenHealth-Core/pull/12)).
+- CI checks, security policy, and release notes ([#13](https://github.com/gematik/OpenHealth-Core/pull/13), [#16](https://github.com/gematik/OpenHealth-Core/pull/16)).
+- Swift and Kotlin binding workflows and related packaging updates ([#25](https://github.com/gematik/OpenHealth-Core/pull/25)).
+
+Changed
+- ASN.1 tag handling and EC key encoding refactor ([#10](https://github.com/gematik/OpenHealth-Core/pull/10)).
+- General API refactoring across modules ([#21](https://github.com/gematik/OpenHealth-Core/pull/21)).
+- Smartcard implementation refactor ([#15](https://github.com/gematik/OpenHealth-Core/pull/15)).
+- Rename trusted channel to secure channel ([#23](https://github.com/gematik/OpenHealth-Core/pull/23)).
+- Migration focus from KMP-first to Rust core.
+- Repository packaging and release workflow adjustments (Package.swift move, Swift wrapper handling, pipeline streamlining) ([#27](https://github.com/gematik/OpenHealth-Core/pull/27), [#28](https://github.com/gematik/OpenHealth-Core/pull/28), [#26](https://github.com/gematik/OpenHealth-Core/pull/26)).
+
+Fixed
+- OpenSSL config ([#9](https://github.com/gematik/OpenHealth-Core/pull/9)).
+
+Security
+- Replace CC0 with Apache-2.0 and add REUSE headers ([#14](https://github.com/gematik/OpenHealth-Core/pull/14), [#11](https://github.com/gematik/OpenHealth-Core/pull/11)).
+- Dynamic license header for generated `ossl.rs` ([#17](https://github.com/gematik/OpenHealth-Core/pull/17)).
+
+Dependencies
+- Dependabot config/allowlist and dependency bumps ([#29](https://github.com/gematik/OpenHealth-Core/pull/29), [#33](https://github.com/gematik/OpenHealth-Core/pull/33), [#31](https://github.com/gematik/OpenHealth-Core/pull/31), [#32](https://github.com/gematik/OpenHealth-Core/pull/32), [#30](https://github.com/gematik/OpenHealth-Core/pull/30)).
+
+### 0.0.1-alpha1 –> 0.0.1-alpha4
+- KMP → Rust core migration
+
+### 0.1.2-POPP_RELEASE (June 23, 2025)
+
+- Older version that only works with the JVM.
+- Backports from main for some test related fixes.
+
+### 0.1.1-POPP_RELEASE (June 23, 2025)
+
+- Older version that only works with the JVM.
+- Backports from main for some test related fixes.