docs: fix stale release, contributing, and Java-compat instructions (#312)

- RELEASING.md: the default branch is `main`, not `master`; the snapshot
  workflow only fires on push to `main`. Update the merge-target references
  in steps 9 and 10.
- CONTRIBUTING.md: the example apps live under `samples/`, not `/example/`,
  and `installDebug` must target a sample module
  (`./gradlew :samples:kotlin-android-app:installDebug`). Also replace the
  React-Native-template commit examples (class-components-to-hooks, detox)
  with Kotlin-relevant ones.
- JAVA_COMPAT.md: the library ships on Maven Central under
  `com.segment.analytics.kotlin` (current 1.25.0), not jitpack. Replace the
  jitpack badge/repository/coordinates with Maven Central and drop the stale
  'Pilot phase' notice.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: abueide

CONTRIBUTING.md

@@ -10,11 +10,11 @@ To get started with the project
 - clone this repository
 - import the project into Android Studio
 
-While developing, you can run the [example app](/example/) to test your changes.
+While developing, you can run one of the [example apps](/samples/) to test your changes.
 - You can do this via the IDE itself using the `Run app` button in the toolbar
-- You can install the debug version of the app using the gradle command:
+- You can install the debug version of an app using the gradle command (targeting a specific sample module):
 ```
-./gradlew installDebug
+./gradlew :samples:kotlin-android-app:installDebug
 ```
 
 Remember to add tests for your change if possible. Run the unit tests:
@@ -30,9 +30,9 @@ We follow the [conventional commits specification](https://www.conventionalcommi
 
 - `fix`: bug fixes, e.g. fix crash due to deprecated method.
 - `feat`: new features, e.g. add new method to the module.
-- `refactor`: code refactor, e.g. migrate from class components to hooks.
-- `docs`: changes into documentation, e.g. add usage example for the module..
-- `test`: adding or updating tests, eg add integration tests using detox.
+- `refactor`: code refactor, e.g. extract a helper or restructure a plugin.
+- `docs`: changes into documentation, e.g. add usage example for the module.
+- `test`: adding or updating tests, e.g. add unit tests for a new plugin.
 - `chore`: tooling changes, e.g. change CI config.
 
 ### Linting and tests

JAVA_COMPAT.md

@@ -1,12 +1,8 @@
 # Analytics-Kotlin Java Compatibility 
-[![](https://jitpack.io/v/segmentio/analytics-kotlin.svg)](https://jitpack.io/#segmentio/analytics-kotlin)
+[![maven](https://img.shields.io/maven-central/v/com.segment.analytics.kotlin/android)](https://repo1.maven.org/maven2/com/segment/analytics/kotlin/)
 
 The hassle-free way to add Segment analytics to your kotlin app (Android/JVM).
 
-NOTE: This project is currently in the Pilot phase and is covered by Segment's [First Access & Beta Preview Terms](https://segment.com/legal/first-access-beta-preview/).  We encourage you
-to try out this new library. Please provide feedback via Github issues/PRs, and feel free to submit pull requests.  This library will eventually 
-supplant our `analytics-android` library.
-
 NOTE: This document serves as an explanation of usage of this `analytics-kotlin` library for pure Java codebase. For the sample usages in Kotlin and more detailed architectural explanation, please refer to our main [README.md doc](README.md).
 
 ## Table of Contents
@@ -35,19 +31,19 @@ NOTE: This document serves as an explanation of usage of this `analytics-kotlin`
   - [License](#license)
 
 ## Installation
-For our pilot phase, we will be using [jitpack](https://jitpack.io/#segmentio/analytics-kotlin) to distribute the library
+The library is published to Maven Central under the `com.segment.analytics.kotlin` group.
 <details open>
 <summary>Android</summary>
 <br>
 In your app's build.gradle file add the following
 
 ```groovy
 repositories {
-    maven { url 'https://jitpack.io' }
+    mavenCentral()
 }
 
 dependencies {
-    implementation 'com.github.segmentio.analytics-kotlin:android:+'
+    implementation 'com.segment.analytics.kotlin:android:1.25.0'
 }
 ```
 
@@ -60,11 +56,11 @@ dependencies {
 In your app's build.gradle file add the following
 ```groovy
 repositories {
-    maven { url 'https://jitpack.io' }
+    mavenCentral()
 }
 
 dependencies {
-    implementation 'com.github.segmentio.analytics-kotlin:core:+'
+    implementation 'com.segment.analytics.kotlin:core:1.25.0'
 }
 ```
 </details>

RELEASING.md

@@ -15,7 +15,7 @@ Releasing
 6. Upgrade to next version by changing version in `gradle.properties`
 7. `git commit -am "Prepare snapshot X.Y.Z-SNAPSHOT"`
 8. `git push && git push --tags`
-9. Create a PR to merge the new branch into `master`
+9. Create a PR to merge the new branch into `main`
 10. The CI pipeline will recognize the tag and upload, close and promote the artifacts automatically, and generate changelog automatically
 
 Example (stable release)
@@ -30,4 +30,4 @@ Example (stable release)
 7. Change VERSION_NAME = 1.3.2 (next higher version)
 8. `git commit -am "Prepare snapshot 1.3.2-SNAPSHOT"`
 9. `git push && git push --tags`
-10. Merging PR master will create a snapshot release 1.3.2-SNAPSHOT and tag push will create stable release 1.3.1
+10. Merging the PR into `main` will create a snapshot release 1.3.2-SNAPSHOT and the tag push will create stable release 1.3.1