all index.md files renamed to README.md for more compatibility with github

value-object/README.md

@@ -0,0 +1,34 @@
+---
+layout: pattern
+title: Value Object
+folder: value-object
+permalink: /patterns/value-object/
+categories: Creational
+tags:
+ - Java
+ - Difficulty-Beginner
+---
+
+## Intent
+Provide objects which follow value semantics rather than reference semantics.
+This means value objects' equality are not based on identity. Two value objects are
+equal when they have the same value, not necessarily being the same object.
+
+![alt text](./etc/value-object.png "Value Object")
+
+## Applicability
+Use the Value Object when
+
+* you need to measure the objects' equality based on the objects' value
+
+## Real world examples
+
+* [java.util.Optional](https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html)
+* [java.time.LocalDate](https://docs.oracle.com/javase/8/docs/api/java/time/LocalDate.html)
+* [joda-time, money, beans](http://www.joda.org/)
+
+## Credits
+
+* [Patterns of Enterprise Application Architecture](http://www.martinfowler.com/books/eaa.html)
+* [VALJOs - Value Java Objects : Stephen Colebourne's blog](http://blog.joda.org/2014/03/valjos-value-java-objects.html)
+* [Value Object : Wikipedia](https://en.wikipedia.org/wiki/Value_object)