Update for version=3.0.0

Author: kerrykimbrough

README.md

@@ -2,8 +2,12 @@
 
 ## What's New? ##
 
-  * The latest version ([Tcases 2.1.2](ReleaseNotes.md#212)) is now available at the Maven Central Repository.
-    See [HowToDownload](HowToDownload.md) for download instructions. 
+  * The latest version ([Tcases 3.0.0](ReleaseNotes.md#300)) is now available at the Maven Central Repository.
+    See [HowToDownload](HowToDownload.md) for download instructions.
+
+  * Tcases 3.0.0 introduces [support for JSON](http://www.cornutum.org/tcases/docs/Tcases-Json.htm), for all documents that Tcases reads and produces.
+    Also included is a major reorganization of the Tcases API, which is not fully compatible with previous releases
+    -- see the [release notes](ReleaseNotes.md#300) for details.
 
   * Subscribe to the [Tcases Forum](https://groups.google.com/d/forum/tcases) group to get notifications and share experiences with other Tcases users.
 
@@ -17,17 +21,18 @@ Tcases gives you a way to define the input space for your system in a form that
 
 ## How Does It Work? ##
 
-First, you create a system input definition, an XML document that defines your system as a set of functions. For each system function, the system input definition defines the variables that characterize the function input space.
+First, you create a system input definition, a document that defines your system as a set of functions. For each system function, the system input definition defines the variables that characterize the function input space.
 
-Then, you can create a generator definition. That's another XML document that defines the coverage you want for each system function. The generator definition is optional. You can skip this step and still get a basic level of coverage.
+Then, you can create a generator definition. That's another document that defines the coverage you want for each system function. The generator definition is optional. You can skip this step and still get a basic level of coverage.
 
-Finally, you run Tcases. Tcases is a Java program that you can run from the command line or using the [Tcases Maven Plugin](http://www.cornutum.org/tcases/docs/tcases-maven-plugin/). The command line version of Tcases comes with built-in support for running using a shell script or an ant target. Using your input definition and your generator definition, Tcases generates a system test definition. The system test definition is an XML document that lists, for each system function, a set of test cases that provides the specified level of coverage. Each test case defines a specific value for every function input variable. Tcases generates not only valid input values that define successful test cases but also invalid values for the tests cases that are needed to verify expected error handling.
+Finally, you run Tcases. Tcases is a Java program that you can run from the command line or using the [Tcases Maven Plugin](http://www.cornutum.org/tcases/docs/tcases-maven-plugin/). The command line version of Tcases comes with built-in support for running using a shell script or an ant target. Using your input definition and your generator definition, Tcases generates a system test definition. The system test definition is an document that lists, for each system function, a set of test cases that provides the specified level of coverage. Each test case defines a specific value for every function input variable. Tcases generates not only valid input values that define successful test cases but also invalid values for the tests cases that are needed to verify expected error handling.
 
-Of course, the system test definition is not something you can execute directly. But it follows a well-defined XML schema, which means you can use a variety of XML transformation tools to convert it into a form that is suitable for testing your system. For example, Tcases comes with a built-in transformer that converts a system test definition into a Java source code template for a JUnit or TestNG test class.
+Of course, the system test definition is not something you can execute directly. But it follows a well-defined schema, which means you can use a variety of XML transformation tools to convert it into a form that is suitable for testing your system. For example, Tcases comes with a built-in transformer that converts a system test definition into a Java source code template for a JUnit or TestNG test class.
 
 ## Get Started! ##
 
   * [Tcases: The Complete Guide](http://www.cornutum.org/tcases/docs/Tcases-Guide.htm)
+  * [Tcases: The JSON Guide](http://www.cornutum.org/tcases/docs/Tcases-Json.htm): A companion to the _Complete Guide_ adding info specific to JSON
   * [The Tcases Maven Plugin](http://www.cornutum.org/tcases/docs/tcases-maven-plugin/)
   * [How To Download Using Maven](HowToDownload.md)
   * [Model-Driven Testing Using Tcases](ModelDrivenTestingForAgileTeams.md)

ReleaseNotes.md

@@ -1,5 +1,28 @@
 # Release Notes #
 
+## 3.0.0 ##
+
+This release introduces a major new feature: you can now use JSON for all of the documents that Tcases reads and produces.  At
+the command line level (including Tcases Maven Plugin configuration parameters), not much has changed -- just start using
+`*.json` files instead of `*.xml` files.  [Tcases: The JSON Guide](http://www.cornutum.org/tcases/docs/Tcases-Json.htm) explains
+the new JSON file formats and other necessary details.
+
+Why JSON? Many people just find this format easier to read and write. Also, the JSON format is especially useful if you are
+accessing Tcases using a Web service. In fact, using JSON, there is a way to define all Tcases inputs in [a single
+request](http://www.cornutum.org/tcases/docs/Tcases-Json.htm#web).
+
+Another major change is that Tcase APIs have been reorganized into multiple JARs. The improvement in modularity allows API users to
+streamline dependencies to only those components actually needed. But these changes are not fully compatible with previous releases,
+so API users may need to make changes to their projects, as described below.
+
+  * Programs that use CLI classes (`TcasesCommand`, etc.) must change dependencies to use `org.cornutum.tcases:tcases-cli`.
+  
+  * Programs that directly read or write Tcases documents (using classes like `SystemlnputDocReader`, `SystemTestDocWriter`, etc.)
+must change dependencies to use `org.cornutum.tcases:tcases-io`.
+  
+  *  The main utility classes `TcasesCommand` and `Tcases` have been refactored, relocating methods that use stream IO directly to the new class `TcasesIO` in the `tcases-io` module. Also, the superfluous inheritance relationships among these classes have been removed.
+
+
 ## 2.1.2 ##
 
 Minor improvements, including some documentation touch-ups and some refactoring using functional expressions to simplify and clarify the code.

pom.xml

@@ -7,7 +7,7 @@
   <groupId>org.cornutum.tcases</groupId>
   <artifactId>tcases</artifactId>
   <packaging>pom</packaging>
-  <version>3.0.0-SNAPSHOT</version>
+  <version>3.0.0</version>
 
   <name>Tcases</name>
   <description>Generates test cases from system input space models</description>

tcases-ant/pom.xml

@@ -7,7 +7,7 @@
   <parent>
     <groupId>org.cornutum.tcases</groupId>
     <artifactId>tcases</artifactId>
-    <version>3.0.0-SNAPSHOT</version>
+    <version>3.0.0</version>
   </parent>
 
   <artifactId>tcases-ant</artifactId>

tcases-cli/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.cornutum.tcases</groupId>
         <artifactId>tcases</artifactId>
-        <version>3.0.0-SNAPSHOT</version>
+        <version>3.0.0</version>
     </parent>
 
     <artifactId>tcases-cli</artifactId>

tcases-io/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.cornutum.tcases</groupId>
         <artifactId>tcases</artifactId>
-        <version>3.0.0-SNAPSHOT</version>
+        <version>3.0.0</version>
     </parent>
 
     <artifactId>tcases-io</artifactId>

tcases-lib/pom.xml

@@ -7,7 +7,7 @@
   <parent>
     <groupId>org.cornutum.tcases</groupId>
     <artifactId>tcases</artifactId>
-    <version>3.0.0-SNAPSHOT</version>
+    <version>3.0.0</version>
   </parent>
 
   <artifactId>tcases-lib</artifactId>

tcases-maven-plugin/pom.xml

@@ -7,7 +7,7 @@
   <parent>
     <groupId>org.cornutum.tcases</groupId>
     <artifactId>tcases</artifactId>
-    <version>3.0.0-SNAPSHOT</version>
+    <version>3.0.0</version>
   </parent>
 
   <artifactId>tcases-maven-plugin</artifactId>

tcases-shell/pom.xml

@@ -7,7 +7,7 @@
   <parent>
     <groupId>org.cornutum.tcases</groupId>
     <artifactId>tcases</artifactId>
-    <version>3.0.0-SNAPSHOT</version>
+    <version>3.0.0</version>
   </parent>
 
   <artifactId>tcases-shell</artifactId>