From 8ec2f23fd559a5aae28c968e76b35479b3a42496 Mon Sep 17 00:00:00 2001
From: Trask Stalnaker <trask.stalnaker@gmail.com>
Date: Mon, 10 Feb 2025 15:35:40 -0800
Subject: [PATCH] Add CONTRIBUTING.md (#596)

---
 CONTRIBUTING.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000000..e32737ab42
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,29 @@
+# Contributing
+
+Welcome to the OpenTelemetry Java Examples repository!
+
+## Building
+
+Java 17 or higher is required to build the projects in this repository.
+To check your Java version, run:
+
+```bash
+java -version
+```
+
+To build the project, run:
+
+```bash
+./gradlew assemble
+```
+
+## Style guide
+
+This repository follows the OpenTelemetry Java
+repository's [style guide](https://github.com/open-telemetry/opentelemetry-java/blob/main/CONTRIBUTING.md#style-guideline).
+
+## Gradle conventions
+
+- Use kotlin instead of groovy
+- Plugin versions should be specified in `settings.gradle.kts`, not in individual modules
+- All modules use `plugins { id("otel.java-conventions") }`