Problem

GitHub Actions has some confusing behaviour related to the handling of data types in variables. Notably, one area of confusion is the handling of booleans and strings (which GitHub Actions seems to keep mixing up).

There are also several ways actions can receive inputs and outputs and the behaviour there is also a bit confusing. Better docs, at least for our usage of GH Actions, can go a long way in making our workflows maintainable long-term.

Description

Increase documentation around these variables and their usages, both in the action YAML file and in separate documentation in docs.openverse.org to make future development on these workflows easier and clearer.

Additional context

Here are some helpful resources.

• Boolean inputs are not actually booleans actions/runner#1483
• GitHub Actions: Input types for manual workflows
• on.workflow_dispatch.inputs