Address frequently asked questions
What does this MR do and why?
This MR adds a Frequently Asked Questions section and addresses long-form remote step references.
We have implemented the long-form step reference to support nested steps while we deliberate the format of the short form. See step-runner#16 (comment 1870046792) This came up in https://gitlab.com/gitlab-org/ux-research/-/issues/3008#note_1910938971 and it wasn't documented. cc @lma-git
There were two questions from users about referencing steps in other "files" / repos, and mixing scripts with steps. See https://www.youtube.com/watch?v=xMkvrZMnIrQ&t=838s. cc @dnsmichi @sunjungp
And @dhershkovitch has received a request for CI Components to support side-car files and asked about support in steps. The ${{ step_dir }}
expression is already referenced in the docs, but this MR adds a FAQ entry to expand on that.