svn commit: r1067875 - /tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-contribution/README

[an...@apache.org]

Author: antelder
Date: Mon Feb  7 08:13:10 2011
New Revision: 1067875

URL: http://svn.apache.org/viewvc?rev=1067875&view=rev
Log:
README edits

Modified:
    tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-contribution/README

Modified: tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-contribution/README
URL: http://svn.apache.org/viewvc/tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-contribution/README?rev=1067875&r1=1067874&r2=1067875&view=diff
==============================================================================
--- tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-contribution/README (original)
+++ tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-contribution/README Mon Feb  7 08:13:10 2011
@@ -5,32 +5,38 @@ This sample demonstrates a simple hellow
 
 See the README in the top-level samples folder for general information on the Tuscany samples.
 
-This project creates a jar format SCA contribution which has a deployable SCA composite. The composite
-defines a single component named "HelloworldComponent" which implements a Helloworld service which
-is implemented by a Java class. A JUnit testcase tests running the composite and invoking the service.
+This project creates a jar format SCA contribution with a deployable composite, helloworld.comosite.
+The composite defines an SCA component, HelloworldComponent, which provides a Helloworld service, 
+the component is implemented by a Java class. 
 
-You can use the contribution built in the Tuscany Shell - at the root of a Tuscany binary distribution 
-run the following command:
+You can use the contribution by installing it and starting the composite in the Tuscany Shell. To do
+that run the following command in the helloworld-contribution folder:
 
-   bin\tuscany.bat samples\getting-started\helloworld-contribution  
+   mvn tuscany:run 
+
+Alternatively, the Tuscany Shell can be started with the scripts in the Tuscany binary distribution 
+bin folder. To do that run the following command at the root of a Tuscany binary distribution:
 
-You may then call the helloworld service with the shell command:
+   bin\tuscany.bat samples\getting-started\helloworld-contribution  
 
-   invoke HelloworldComponent sayHello "your name"
+Once the Shell has been started with one of those methods you can use Shell commands to explore
+the SCA domain, for example, use the "installed" command to get the status of installed contributions, 
+"services" to see the available component services. You may test calling the helloworld service by 
+using the "invoke" command:
 
+   invoke HelloworldComponent sayHello yourName
 
 ---
  
 This sample was created by the Tuscany contribution-jar Maven archetype. You can use that archetype to 
-create you own SCA contribution projects by running the following maven command:
+create your own SCA contribution projects by running the following Maven command:
 
    mvn archetype:generate -DarchetypeCatalog=http://tuscany.apache.org
 
-at the prompt select 1 to choose the contribution-jar archetype and then answer the questions. This project
-used the following answers:
+then at the prompt select 1 to choose the contribution-jar archetype and then answer the questions. 
+This project used the following answers:
 
    Define value for property 'groupId': : org.apache.tuscany.sca.samples
    Define value for property 'artifactId': : helloworld-contribution
    Define value for property 'version': 1.0-SNAPSHOT: 2.0-SNAPSHOT
    Define value for property 'package': org.apache.tuscany.sca.samples: sample  
-