1 files changed, 21 insertions, 0 deletions
diff --git a/sandbox/eightball-demo/README.txt b/sandbox/eightball-demo/README.txt
new file mode 100644
index 0000000000..606c467e6a
--- /dev/null
+++ b/sandbox/eightball-demo/README.txt
@@ -0,0 +1,21 @@
+Eight Ball Demo
+---------------
+
+The Eight Ball Demo is a lighthearted application based on the Magic 8-Ball toy (http://en.wikipedia.org/wiki/Magic_8-Ball) to demonstrate the Tuscany distributed domain support.
+
+There is a eightball.jar SCA contribution which has a Java component that answers yes-no questions, and an eightball-test.jar which is a simple test harness to invoke the EightBall service from the command line. To make the demo more interesting the eightball gives the answers in German.
+
+There is a translator.jar and contribution which has a component that can translate phrases between German and English, and a translator-test.jar for testing that at the command line. Presently the translator is just hardcoded with the phrases the EIghtball uses, later it would be good to enhance the translator to use one of Tuscanys bindings to call one of the remote translaotr services available on the internet.
+
+There is a eightball-process.jar contribution which has a Java component which uses the translator and eightball services to translate phrases from English to German, ask the eightball the question, and then translate the answer from German to English. Ideally this would be rewritten using BPEL. And an associated eightball-process-test.jar to test it at the command line.
+
+And finally there's an eightball-webapp which has a simple webapp to invoke all that from a web gui. Presently this doesn't embed the Tuscany runtime so needs to run on a Tomact with the tuscany.war distribution installed.
+
+
+
+
+
+
+
+
+