Project

General

Profile

Actions

action #126179

closed

Some presentations reference the "openQA DSL" but open.qa doesn't mention it anywhere size:S

Added by okurz about 1 year ago. Updated about 1 year ago.

Status:
Resolved
Priority:
Normal
Assignee:
Category:
Feature requests
Target version:
Start date:
2023-03-18
Due date:
% Done:

0%

Estimated time:

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.

Actions #1

Updated by livdywan about 1 year ago

What presentations are those? And what DSL is being referred to here?

Actions #2

Updated by okurz about 1 year 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

Actions #3

Updated by livdywan about 1 year ago

  • Subject changed from Some presentations reference the "openQA DSL" but open.qa doesn't mention it anywhere to Some presentations reference the "openQA DSL" but open.qa doesn't mention it anywhere size:S
  • Description updated (diff)
  • Status changed from New to Workable
Actions #4

Updated by kraih about 1 year ago

  • Assignee set to kraih
Actions #5

Updated by kraih about 1 year ago

  • Status changed from Workable to In Progress
Actions #6

Updated by livdywan about 1 year ago

  • Status changed from In Progress to Feedback

kraih wrote:

PR: https://github.com/os-autoinst/openQA/pull/5059

That was quick :-D

Actions #7

Updated by livdywan about 1 year ago

  • Status changed from Feedback to Resolved

I was able to find "DSL" in our deployed docs.

Actions

Also available in: Atom PDF