sugar-trail/README.md

Synopsis

Header: value of any kind
Other-header: name1=value1; name2=value2
Another-one: something else

After an empty linem, body starts. Just like MIME.

The body is basically Markdown with some modifications discussed later.

#case name#
1. instruction
   > expected result (or check point, or oracle)
   > another expected result {fam>10} {os~win*}
2. cond. instruction
   * yes: opt 1
   * no: opt 2
0. Assertion (specifically zero, can be anywhere)
3. another instruction

Descrription

Basic form is similar to MIME. First headers, then, after one empty line, the body, up to the EOF. Just like in MIME, headers are only for mete-data--thery are not visible in the final outpput.

Inside header, various parameter lranges like OSes, architectures, product editions or hardware types can be declared. Later entities (e.g. instructions) can be conditioned using these.

This is also meant to allow for generation of set of ready procedures with variations of parameters.

Rules

• if assertion -or- instruction fails
  • IN is generated
  • rest of test case is skipped
• if expected result fails
  • IN is generated
  • TC goes on

Terms

• IN - incident note
  • note itself
  • bug eport?
• TC - test case
• ST - sugar trail (trail of test cases)

---

Name:

Putting giraffe into fridge

1. Open the fridge
2. Put the giraffe into the fridge
3. Close the fridge

Putting elephant into fridge

1. Open the fridge
2. Take the giraffe put of the fridge
3. Put the elephant into the fridge
4. Close the fridge

Emptying fridge

1. Open the fridge
2. What is inside the fridge?
   • elephant: take out the elephant
   • giraffe: take out the giraffe
3. Closer the fridge !. Fridge is empty

Taking elephant out of the fridge

1. There is an elephant inside the firdge
2. Open the fridge > fridge opens well
3. Look inside the fridge > you see elephant > elephant has a pullover > elephant is not cold
4. Take the elephant out of the fridge > elephant does not fight > elephant looks happier outside the fridge > it does not make too much sound
5. everybody is sleeping
6. Close the fridge > Fridge closes well

TODO

• define keyboard shortcuts (not the ugly `Shift+F8)