Add docs about automatically using git ssh urls for pushing

[perlpunk]

Issue: https://progress.opensuse.org/issues/174592

I will add a link to this documentation to the needle admin error message in a followup PR.
This will take a bit more time because we don't have low level unit tests for needle admin yet. (edit: actually we have, but I will do a followup PR)

[github-actions]

Great PR! Please pay attention to the following items before merging:

Files matching docs/*.asciidoc:

• Consider generating documentation locally to verify it is rendered correctly using tools/generate-docs

This is an automatically generated QA checklist based on modified files.

[perlpunk]

• Consider generating documentation locally to verify it is rendered correctly using tools/generate-docs

% tools/generate-docs
asciidoc not found in PATH.
Fallback to Rubygem's Asciidoc
tools/generate-docs: line 18: bundle: command not found

What do I need to do here? I remember this was running in a container in the past, but it was changed. Not sure what I am missing.

[perlpunk]

I also tried the suggestion from docs/Contributing.asciidoc

% podman run --rm -v OPENQA_LOCAL_CODE:/opt/openqa openqa_devel:latest make generate-docs
✔ registry.opensuse.org/openqa_devel:latest
Trying to pull registry.opensuse.org/openqa_devel:latest...
Error: initializing source docker://registry.opensuse.org/openqa_devel:latest: reading manifest latest in registry.opensuse.org/openqa_devel: name unknown

and

% podman run --rm -v OPENQA_LOCAL_CODE:/opt/openqa registry.opensuse.org/devel/openqa/containers/opensuse/openqa_devel:latest make generate-docs
make: *** No rule to make target 'generate-docs'.  Stop.

I will create a ticket about improving the instructions. Meanwhile, the change is hopefully simple enough that I don't need to check he HTML for this one?

[okurz]

@josegomezr can you remind us why your change helps here? :)

[perlpunk]

ok, got it working:

podman run --rm -v $PWD:/opt/openqa registry.opensuse.org/devel/openqa/containers/opensuse/openqa_devel:latest make generate-docs