Add doc

docs/_sidebar.md

@@ -96,9 +96,6 @@
   - [Request IO](/communication/request_io.md)
   - [JSON RPC](/communication/rpc.md)
 
-- Testing (tbd)
-
-- Deployment (tbd)
 
 - Development
   - ["qx" CLI commands](/compiler/cli/commands.md)
@@ -108,6 +105,11 @@
     - [compile.json](/compiler/configuration/compile.md)
     - [API](/compiler/configuration/api.md)
   - [Advanced compiler topics](/compiler/internals/)
+  - [Migrating from Python to qx toolchain](/compiler/migration.md)
+
+- [**Testing**](/compiler/cli/testing.md)
+
+- Deployment (tbd)
 
 
 - Tutorials

docs/compiler/cli/commands.md

@@ -1,4 +1,4 @@
-### CLI Commands
+# CLI Commands
 
 The qooxdoo CLI commands allow to conveniently create, modify, compile, testand publish
 and publish your qooxdoo project. To see the main available commands, type
@@ -30,7 +30,7 @@ Commands:
 
 To see the subcommands parameters and options, just type in `qx <command> --help`.
 
-# Persistent Configuration
+## Persistent Configuration
 
 Some commands require (or benefit from) having persistent configuration; this is
 accessed via the `qx config` command and the data is stored in a directory

docs/compiler/cli/testing.md

@@ -0,0 +1,45 @@
+# Testing of your application
+
+Testing of your qooxdoo app can be done by the qooxdoo cli command `qx test`.
+For this purpose you need to install one of the provide test plugins:
+  - qooxdoo/qxl.testtapper: Runs units tests based on `qx.dev.unit.TestCase`
+
+## Preparing your application
+
+  - install testapper with `qx package install qooxdoo/qxl.testtapper --save=0`
+  - prepare testapper application in your `compile.json` by adding your test namespace:
+
+```
+      "environment": {
+        "testtapper.testNameSpace": "myapp.test"
+      },
+```	  
+
+   - include your test classes
+
+```	  
+      "include": [
+        "myapp.test.*"
+      ],
+```	  
+
+   - write some tests:
+```
+qx.Class.define("myapp.test.MyTest",
+{
+  extend : qx.dev.unit.TestCase,
+  members :
+  {
+    testOne : function() {
+      this.assertTrue(1 === 1);
+  }
+});
+```
+
+   - run `qx test` and check result.
+
+## Hints   
+
+   - to run a single test you can use `qx test --class myapp.test.MyTest --method testOne`
+
+

docs/compiler/migration.md

@@ -0,0 +1,25 @@
+# Migrate your application from qooxdoo 5.0 to qooxdoo 6.0 toolchain
+
+   - create new application with `qx create oldName` using the information provided in old/Manifest.json
+  - replace some folders in the new application with the conterparts of the old application
+      - old/source/class -> new/source/class
+      - old/source/resource -> new/source/resource
+      - old/source/translation -> new/source/translation
+  - move old/source/index.html to new/source/boot/index.html
+  - add this into new/source/boot/index.html just before `</head>`
+```
+  ${preBootJs}
+  <script type="text/javascript" src="${appPath}boot.js"></script>
+```
+ - find out which libraries are used in the old application. For this have a look into `compile.json` libraries section. Add all libraries found here with 
+```
+qx pkg update
+qx pkg list  
+qx pkg install library
+```
+Hopefully all needed libraries are converted.
+
+ - find used theme in old/compile.json and set this in new/compile.js
+ - run `qx compile` and fix errors
+ - run `qx serve` to run build in webserver and test it in your browser `http://localhost:8080/`
+