Add workflow dispatch and allow workflow names.

[fodinabor]

Adds the workflow dispatch proposed in #939.
This is different from the repository dispatch, as here it is clear what arguments to use, so that this is much more convenient to use.

Also update docs link.

[bummzack]

I'm looking for this functionality as well. Any chance to get this merged?
Or are there currently other ways to trigger a workflow-dispatch event?

[bummzack]

I've tested using this PR, but there's an issue when dispatching without the optional $inputs param.

For 'properties/inputs', [] is not an object.

I think inputs should be omitted if there's no input to be specified… this works:

public function dispatches(string $username, string $repository, string $workflow, string $ref, array $inputs = null)
{
    $parameters = array_filter(['ref' => $ref, 'inputs' => $inputs]);

    return $this->post('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/actions/workflows/'.rawurlencode($workflow).'/dispatches', $parameters);
}

[acrobat]

Thanks for the PR! 1 general remark/question, can you remove the @link url changes and move them to a seperate PR as they are not related to this specific feature. This will allow the git history to give a better insight in why a certain change was done. Thanks!

Apart from 2 comments on the dispatch methods, this pr looks good! 👌

[fodinabor]

should be non-BC breaking now (even though Roave still doesn't like it), will wait for the URL update until this is merged

[acrobat]

Thanks @fodinabor! And congrats on your first contribution! 🎉