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

poison-pill/README.md

@@ -0,0 +1,25 @@
+---
+layout: pattern
+title: Poison Pill
+folder: poison-pill
+permalink: /patterns/poison-pill/
+categories: Other
+tags:
+ - Java
+ - Difficulty-Intermediate
+---
+
+## Intent
+Poison Pill is known predefined data item that allows to provide
+graceful shutdown for separate distributed consumption process.
+
+![alt text](./etc/poison-pill.png "Poison Pill")
+
+## Applicability
+Use the Poison Pill idiom when
+
+* need to send signal from one thread/process to another to terminate
+
+## Real world examples
+
+* [akka.actor.PoisonPill](http://doc.akka.io/docs/akka/2.1.4/java/untyped-actors.html)