Update README.md

Author: tomtzook

README.md

@@ -1,3 +1,31 @@
 # JavaBeans
 
 Library providing java beans utilities and observables.
+Provides interfaces and several implementations for properties, observable data and such.
+
+## Building
+
+Simply run `./gradlew build` from the main directory.
+This will build the library and export it along with a sources jar and javadoc archive into `build/libs`.
+
+## Properties
+
+JavaBeans introduces the `Property` interface, which is a mutable value. 
+There are also specializations for the interface for primitive types: `long`, `int`, `boolean`, `double`.
+
+### Implementations
+
+JavaBeans provides the following implementations for `Property`, each implementation exists for the specializations as well:
+- Simple: a basic variable value which can be read from and written to.
+- Atomic: a thread-safe implementation.
+
+### Observables
+
+An `ObservableValue` is a value which can be observed for changes using listeners.
+An `ObservableProperty` is a property which can be observed for changed using listeners.
+
+Both `ObservableValue` and `ObservableProperty` have primitive specializations.
+
+There are several implementations provided:
+- Simple: a basic variable value which can be read from and written to.
+- Atomic: a thread-safe implementation.