README: appExclusions ("Pause/resume breaks only when specific command is running") preference documentation unclear

[Chealer]

The README's Pause/resume breaks only when specific command is running section documents the appExclusions preference:

By editing appExclusions in preferences file, you can automatically control when Stretchly breaks are paused.

If you want Stretchly to be paused when specific apps are running, you could have this value (breaks are paused when Skype or Atom are running):

"appExclusions": [
    {
        "rule": "pause",
        "active": true,
        "commands": [
            "/usr/share/skypeforlinux/skypeforlinux",
            "atom"
        ]
    }
]

If you want Stretchly to be running when specific apps are as well, you could have this value (breaks are paused when Skype or Atom are not running):

"appExclusions": [
    {
        "rule": "resume",
        "active": true,
        "commands": [
            "/usr/share/skypeforlinux/skypeforlinux",
            "atom"
        ]
    }
]

You can specify multiple values, (as appExclusions is array) and Stretchly will take the first one that is marked as "active": true.

There are quite a few things unclear here:

1. A "command running" is Unix jargon. In Microsoft Windows terminology, it's processes (or tasks) which run. I suggest to use "program" instead of "command" and "app".
2. It's unclear what happens when multiple values are active.
3. If I understand correctly, the second example "pauses" (suspends) Stretchly unless one of the programs specified executes. If so, the introduction should read "If you want Stretchly to be running only when specific apps are as well […]". And―again if my understanding is correct―the parameter should be named appRequirements, or if it's both for exclusions and requirement, perhaps suspensionRules.
4. The application examples provided are dated/poor. Skype is shutting down (eclipsed by others and replaced by Microsoft Teams), and Atom is deprecated, being eclipsed by Visual Studio Code. I suggest replacing those with Zoom Workplace, Signal Desktop, VS Code and/or VSCodium.

[Chealer]

Skype is officially shutting down, in May.

[Chealer]

2. It's unclear what happens when multiple values are active.

The description says multiple programs are treated as an OR condition. (Either Skype or Atom are running).

I am talking about multiple (top-level) values, not multiple commands.

3. the parameter should be named appRequirements, or if it's both for exclusions and requirement, perhaps suspensionRules.

The parameter appExclusions is fine.

I don't think so, but we can wait until the documentation is fixed and see when it's properly specified.

[Chealer]

I am talking about multiple (top-level) values, not multiple commands.

The documentation says " Stretchly will take the first one that is marked as "active": true".

Yes, but it doesn't say what it does with others.

You can't have both "resume" and "pause".

What do you mean? Stretchly will refuse to start with such files?

[hovancik]

Feel free to try how it behaves.