action #126179
Some presentations reference the "openQA DSL" but open.qa doesn't mention it anywhere size:S
0%
Description
Motivation¶
Feedback from hsehic: We have some presentations referencing a openQA DSL, "Domain specific language" but open.qa doesn't mention it anywhere. we should just mention the term in or near http://open.qa/docs/#_how_to_write_tests or http://open.qa/docs/#_api so that people find it as search term
Acceptance criteria¶
- AC1: The documentation mentions "openQA DSL"
Suggestions¶
- Just add a sentence that explains that the openQA test API can be referred to as openQA DSL, because in some contexts it can look like a domain specific language
- Comparable examples from the Perl world would be the Mojolicious::Lite DSL, or cpanfiles
Remark¶
You can run generic Perl code in tests. We should not give a false impression about it. This is merely so our documentation isn't blank on the term "DSL" that may be used elsewhere.
History
#2
Updated by okurz 3 months ago
cdywan wrote:
What presentations are those?
https://github.com/os-autoinst/documentation or something on the SUSE internal link: https://w3.suse.de/~okurz/presentations
And what DSL is being referred to here?
The "domain specific language" just is the combination of testapi calls with a bit of perl in between: that's why I meant we should just mention the term in or near http://open.qa/docs/#_how_to_write_tests or http://open.qa/docs/#_api