more readme

Author: trevorturk

README.md

@@ -1 +1,7 @@
-Example Ruby apps using async
+# Async examples in Ruby
+
+This is a scratchpad for experimenting with Ruby tools with the aim of serving lots of concurrent requests that hit an external http endpoint that may run slowly, returning JSON, ideally using GraphQL, with batching outside of the GraphQL context.
+
+The simplest working example is the `rack-async-http-falcon-graphql-batch` app. I'd like to understand why adding graphql-ruby's new dataloader doesn't work well. Also I'm not clear on the tradeoffs involved in using threads versus fibers. I don't have a working example with threads (and Puma?) yet, but I assume it's possible to get working well.
+
+If you'd like to play around with any of these examples, add your own, or fix any that aren't working well, I would love your help!