Missing docs of few executors or mapping onto the provided options during registering the runner.

Missing docs of few executors or mapping onto the provided options during registering the runner.

Points of interest:

Running registration script we see this list of runners :

Please enter the executor: docker, docker-ssh, shell, ssh, virtualbox, docker+machine, docker-ssh+machine, kubernetes, custom, parallels:
docker-ssh

In registration docs : Registration process steps:

...

1. Enter the Runner executor:

   Please enter the executor: ssh, docker+machine, docker-ssh+machine, kubernetes, docker, parallels, virtualbox, docker-ssh, shell:
   docker

2. If you chose Docker as your executor, you'll be asked for the default image to be used for projects that do not define one in .gitlab-ci.yml:

   Please enter the Docker image (eg. ruby:2.1):
   alpine:latest

In the executors docs we see some Locked list of executors

• SSH
• Shell
• Parallels
• VirtualBox
• Docker
• Docker Machine (auto-scaling)
• Kubernetes
• Custom

The list of executors above is locked. We no longer are developing or accepting new ones. Please check CONTRIBUTION.md to check the details.

Questions

1. Clearly the list of executors is still changing, why is it stated as locked in the documentation?

2. Please where is docker-ssh explained ?

3. Which docker image would you recomend for other than docker executor? Doubt it that alpine:latest will suffice for the other options ?

4. Maybe there should be an issue for dynamic hint in the last step of registration ?

• Suggestion for implementation: When we select docker > hint will be alpine:latest not ruby:2.6