Docs entry for gitlab-runner exec need clarification
Problem
Some commentators have indicated that the gitlab-runner exec
docs entry suggests this is a full-featured product offering for debugging GitLab CI pipelines on the developer's local machine without needing to push the pipeline changes to a GitLab instance.
As a long-time GitLab CI user, I do miss how the local circleci runner binary just worked. I am aware of gitlab-runner but it is a sick joke designed to mislead folks who just skim the docs into believing that they have a local execution story.
a local execution story I can see how "local" can have multiple meanings, but here I meant "as a developer on my laptop, can I have local docker run things the way GL is going to run things?" I hear people say a lot "oh, I just use shell scripts, NBD" but as I said, I'm sure for hello-world setups which don't have any includes or take advantage of GLCI constructs that can work fine, but what rubs me the wrong way is that "gitlab-runner exec" doesn't say "just use shell scripts," it says "gitlab-runner exec - execute a build locally" and it for sure does not do that.
Proposal
Revise the gitlab-runner exec
docs page so that its 100% clear in the introduction that this feature provides very limited capability for debugging GitLab pipelines.