chore: add basic readmes (#65)

Signed-off-by: Todd Baert <[email protected]>

Author: toddbaert

README.md

@@ -1,6 +1,19 @@
-# java-sdk-contrib
+# OpenFeature Java Contributions
 
-Java SDK contrib
+![Experimental](https://img.shields.io/badge/experimental-breaking%20changes%20allowed-yellow)
+![Alpha](https://img.shields.io/badge/alpha-release-red)
 
-To publish:
-`mvn --no-transfer-progress --batch-mode --settings release/m2-settings.xml verify deploy -Dversion.modifier='-$GITHUB_SHA-SNAPSHOT'`
+This repository is intended for OpenFeature contributions which are not included in the [OpenFeature SDK](https://github.com/open-feature/java-sdk).
+
+The project includes:
+
+- [Providers](./providers)
+- [Hooks](./hooks)
+
+## Releases
+
+This repo uses _Release Please_ to release packages. Release Please sets up a running PR that tracks all changes for the library components, and maintains the versions according to [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/), generated when [PRs are merged](https://github.com/amannn/action-semantic-pull-request). When Release Please's running PR is merged, any changed artifacts are published.
+
+## License
+
+Apache 2.0 - See [LICENSE](./LICENSE) for more information.

hooks/hooks.md

@@ -0,0 +1,3 @@
+# OpenFeature Java Hooks
+
+Hooks are a mechanism whereby application developers can add arbitrary behavior to flag evaluation. They operate similarly to middleware in many web frameworks. Please see the [spec](https://github.com/open-feature/spec/blob/main/specification/flag-evaluation/hooks.md) for more details.

providers/providers.md

@@ -0,0 +1,3 @@
+# OpenFeature Java Providers
+
+Providers are responsible for performing flag evaluation. They provide an abstraction between the underlying flag management system and OpenFeature itself. This allows providers to be changed without requiring a major code refactor. Please see the [spec](https://github.com/open-feature/spec/blob/main/specification/provider/providers.md) for more details.