Document comment target flag and provide examples.

[tasdomas]

This also removes reference to the github checkout ref from the starting example.

• [x] depends on https://github.com/iterative/cml/pull/1228

[github-actions[bot]]

Link Check Report

There were no links to check!

[tasdomas]

This should be landed after the next cml release