docs/dsl/README.md in teuton-2.1.8 vs docs/dsl/README.md in teuton-2.1.9
- old
+ new
@@ -1,23 +1,28 @@
+[<< back](../../README.md)
+# Teuton language
+
To define and run our activity test we use the next DSL keywords:
+1. [Definition instructions](#definition-instructions)
+2. [Execution instructions](#execution-instructions)
+3. [Setting instructions](#setting-instructions)
+4. [Ruby language](#ruby-language)
## Definition instructions
These are the main DSL key words, usefull to define items to be evaluated.
| DSL | Description |
| :----------------------------- | :---------- |
| [group](definition/group.md) | Define a group of items to check. |
| [target](definition/target.md) | Define a target. This is the item to be checked. |
-| [goto](definition/goto.md) | Execute command into remote host. |
-| [run](definition/run.md) | Execute command into localhost. |
+| Remote [run](definition/run_remote.md)| Execute command into remote host. |
+| Local [run](definition/run_local.md) | Execute command into local host. |
| [result](definition/result.md) | Contain the output of previous `goto` order. |
| [expect](definition/expect.md) | Check the obtained result with the expected value. |
----
-
## Execution instructions
DSL key word related with reports and information.
| DSL | DescripciĆ³n |
@@ -25,29 +30,26 @@
| [play](execution/play.md) | Run the challenge. |
| [show](execution/show.md) | Show the results on screen. |
| [export](execution/export.md) | Make reports with the results of every evaluation. |
| [send](execution/send.md) | Send copy of report file to remote host. |
----
-
## Setting instructions
| DSL | DescripciĆ³n |
| :-------------------- | :--------------------------------------------- |
| [get](setting/get.md) | Read param value from configuration file. |
| [set](setting/set.md) | Set new param value for running configuration. |
----
## Ruby language
-It is possible to use ruby language programming structures, in the definition of challenges (iterators, arrays, etc.). Very useful when we have repetitive lines.
+It is possible to use ruby language programming structures, in the definition of our test (iterators, arrays, etc.). Useful when we have repetitive lines, etc.
Example, how to create 4 target evaluation using an Array:
```ruby
users = ['Obiwan', 'Yoda', 'Maul', 'Vader']
users.each do |user|
target "Exist user #{user}"
- goto :host1, :exec => "id #{user}"
+ run "id #{user}", on: :host1
expect_one user
end
```