Merge branch 'master' of github.com:AloisMahdal/sugar-trail

TODO.md

@@ -3,6 +3,7 @@
 
 ## Definition ##
 
+
 ### Syntax ###
 
 *   keyboard shortcuts (not the ugly `<key>Shift</key>+<key>F8</key>)
@@ -17,6 +18,7 @@
 
   [2]: examples/objects.md
 
+
 ### Data model ###
 
 *   step identity
@@ -27,6 +29,29 @@
 
     2.  Markdown
 
+*   inheritance - inherit Vars and other things
+
+*   matrices - allow for generation of combined parallel procedures
+
+*   relations to other (specification) documents
+
+*   equipment - allow for specification of special equipment like Wi-fi cards,
+    or a specific machine or a set of machines (environment).  Can be related
+    to objects
+
+*   objects - allow for
+
+    *   distinct specification of object in group of testing objects (server,
+        client1, client2...)
+
+    *   parallelization when the same procedure needs to be repeated over
+        every object (machines, pages of a document, data sets...)
+
+    Notice the difference: while equipmemt serves as a means of providing
+    framework or environment where tests can be held, objects are separately
+    defined units that tests are actually held against.  In practice, set of
+    objects can be actually a subset of equipment.
+
 
 ### WUI ###
 

notes/inheritance.md

@@ -0,0 +1,39 @@
+INHERITANCE
+===========
+
+Based on organization properties like Groups or Tags (TBD), an inheritance of
+other properties is desirable.
+
+First idea of implementation is a set of configuration files, where each defines
+header contents for certain group.  These items are then inherited to 
+
+
+Quick example
+-------------
+
+`etc/projects/headers.conf:`
+
+    Project: printer_driver
+    Manufacturer: hp, brother
+    Proto: lpt, usb, smb, lpr
+
+Then each STT with `Project: printer_driver` would be automatically appended
+above headers.
+
+
+TODO
+----
+
+*   help avoid conflict
+
+    *   override?
+
+    *   append?
+
+    *   exclude?
+
+    *   duplication: organization by folder structure vs. by groups?
+
+*   define groups
+
+*   inheritance on folders?

notes/matrices.md

@@ -0,0 +1,104 @@
+MATRICES
+========
+
+In cases when (more or less) the same test procedure needs to be performd on a
+group of equivalent and independent objects, ic might be desirable to generate
+collective form, usable for testing in parallel.
+
+
+
+Example
+-------
+
+
+Source STM defines actions that are only valid under certain circumstances.
+
+    Name: Release Client - parallel
+    Description: Example of parallel procedures
+    Vars: arch=amd64,x86
+    
+    # Parallel showcase #
+
+    ## Install ##
+    1. Create a folder with CJK characters
+    2. Install Product
+    3. Open Start menu -> ACME
+    4. Check links
+       * Help.lnk
+       * Product.lnk
+       * Product (64-bit).lnk {arch==amd64}
+    5. Restart
+
+
+The above can result in two STS:
+
+    Stm: /release/rc.stm
+    Stm Revision: 123
+    Params: arch=amd64
+    
+    # Parallel showcase #
+
+    ## Install ##
+    1. Create a folder with CJK characters
+    2. Install Product
+    3. Open Start menu -> ACME
+    4. Check links
+       * Help.lnk
+       * Product.lnk
+       * Product (64-bit).lnk
+    5. Restart
+
+
+    Stm: /release/rc.stm
+    Stm Revision: 123
+    Params: arch=x86
+    
+    # Parallel showcase #
+
+    ## Install ##
+    1. Create a folder with CJK characters
+    2. Install Product
+    3. Open Start menu -> ACME
+    4. Check links
+       * Help.lnk
+       * Product.lnk
+    5. Restart
+
+
+Or one "double" STS -- notice `Params:` header:
+
+    Stm: /release/rc.stm
+    Stm Revision: 123
+    Params: arch=x86+amd64
+    
+    # Parallel showcase #
+
+    ## Install ##
+    1. Create a folder with CJK characters
+    2. Install Product
+    3. Open Start menu -> ACME
+    4. Check links
+       * Help.lnk
+       * Product.lnk
+       * Product (64-bit).lnk {arch==amd64}
+    5. Restart
+
+
+The point is that the double STM can be rendered for parallel processing:
+
+    +-------------------------------------------------------------------+
+    | PARALLEL SHOWCASE                                                 |
+    +-------------------------------------------------------------------+
+    |                                                                   |
+    |  ## Install ##                              x86         amd64     |
+    | 1. Create a folder with CJK characters    [ Passed  ] [ Passed  ] |
+    | 2. Install Product                        [ Passed  ] [ Passed  ] |
+    | 3. Open Start menu -> ACME                [ Passed  ] [ Passed  ] |
+    | 4. Check links                            [ Passed  ] [ Passed  ] |
+    |    * Help.lnk                             [ Passed  ] [ Passed  ] |
+    |    * Product.lnk                          [ Passed  ] [ Failed  ] |
+    |    * Product (64-bit).lnk                             [ Passed  ] |
+    | 5. Restart                                [ Passed  ] [ Passed  ] |
+    |                                                                   |
+    +-------------------------------------------------------------------+
+

notes/table.md

@@ -0,0 +1,59 @@
+# Table #
+
+## Spanning ##
+
+    +-------+-------+-------+
+    | colsp |       |       |
+    | an    +-------+-------+
+    |       |       |       |
+    +-------+-------+-------+
+    |       |       |       |
+    +-------+-------+-------+
+    |       | rowspan       |
+    +-------+-------+-------+
+    |       |       |       |
+    +-------+-------+-------+
+    | colspan and   |       |
+    | rowspan       +-------+
+    |               |       |
+    +-------+-------+-------+
+    |       |       |       |
+    +-------+-------+-------+
+
+
+## Header ##
+
+    +-------+-------+-------+
+    | test# |v    A |v    B |
+    +-------+-------+-------+
+    |>    1 |  pass |  pass |
+    +-------+-------+-------+
+    |>    2 |  fail |  pass |
+    +-------+-------+-------+
+    |>    3 |  fail |  pass |
+    +-------+-------+-------+
+    |>    4 |  pass |  fail |
+    +-------+-------+-------+
+    |>    5 |  fail |  fail |
+    +-------+-------+-------+
+    |>    6 |  pass |  pass |
+    +-------+-------+-------+
+    |>    7 |  fail |  fail |
+    +-------+-------+-------+
+
+      test# |     A |     B |
+    --------+-------+-------+
+          1 |  pass |  pass |
+    --------+-------+-------+
+          2 |  fail |  pass |
+    --------+-------+-------+
+          3 |  fail |  pass |
+    --------+-------+-------+
+          4 |  pass |  fail |
+    --------+-------+-------+
+          5 |  fail |  fail |
+    --------+-------+-------+
+          6 |  pass |  pass |
+    --------+-------+-------+
+          7 |  fail |  fail |
+    --------+-------+-------+