Add readme to examples

examples/README.md

@@ -0,0 +1,30 @@
+# Examples
+
+This directory contains example usage of Micro
+
+**Client** contains examples usage of the Client package to call a service.
+  - main.go - calls each of the go.micro.srv.example handlers and includes the use of the streaming handler
+  - codegen - demonstrates how to use code generation to remove boilerplate code
+  - dc_filter - shows how to use Select filters inside a call wrapper for filtering to the local DC
+  - dc_selector - is the same as dc_filter but as a Selector implementation itself
+  - pub - publishes messages using the Publish method. By default encoding in protobuf
+  - selector - shows how to write and load your own Selector
+  - wrapper - provides examples for how to use client Wrappers (middleware)
+
+**PubSub** contains an example of using the Broker for Publish and Subscribing.
+  - main.go - demonstrates simple runs pub-sub as two go routines running for 10 seconds.
+  - producer - publishes messages to the broker every second
+  - consumer - consumes any messages sent by the producer
+
+**Server** contains example usage of the Server package to server requests.
+  - main.go - initialises and runs the the server
+  - handler - is an example RPC request handler for the Server
+  - proto - contains the protobuf defintion for the Server API
+  - subscriber - is a handler for subscribing via the Server
+  - wrapper - demonstrates use of a server HandlerWrapper
+  - codegen - shows how to use codegenerated registration to reduce boilerplate
+
+**Service** contains example usage of the top level Service in go-micro.
+  - main.go - is the main definition of the service, handler and client
+  - proto - contains the protobuf definition of the API
+  - wrapper - demonstrates the use of Client and Server Wrappers