Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

v2 #70

Merged
merged 33 commits into from
Jul 25, 2020
Merged

v2 #70

merged 33 commits into from
Jul 25, 2020

Conversation

peter-evans
Copy link
Owner

@peter-evans peter-evans commented Jul 22, 2020

README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
Comment on lines +11 to +14
- When issuing a slash command with arguments, *only named arguments are accepted*. Unnamed arguments will be ignored.
- A maximum of 10 named arguments are accepted. Additional named arguments after the first 10 will be ignored.
- `ref` is a reserved named argument that does not count towards the maximum of 10. This is used to specify the target reference of the command. The reference can be a branch, tag, or a commit SHA. If you omit the `ref` argument, the target repository's default branch will be used.
- A `client_payload` context cannot be sent with [workflow_dispatch](https://docs.github.com/en/actions/reference/events-that-trigger-workflows#workflow_dispatch) events. The target workflow can only make use of up to 10 pre-defined inputs, the names of which must match named arguments supplied with the slash command.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this paragraph perfectly describes the limitations of a workflow_dispatch.

what I am missing in the docs is a example/description why/when it makes sense to use workflow_dispatch over repository_dispatch. when does workflow_dispatch have a benefit over repository_dispatch?

Copy link
Owner Author

@peter-evans peter-evans Jul 24, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To be honest, I'm not sure myself yet. I wanted to add the feature and allow people to execute workflow_dispatch workflows with slash commands, but I'm not sure exactly why you would choose that workflow type over repository_dispatch if you were intending to execute it by slash command from the start. I think what is more likely is that users are going to start to create workflow_dispatch workflows to run manually from the UI. Then they might find this action and be interested in executing them by slash command. This feature allows them to do that without converting the workflow to repository_dispatch.

If additional benefits become clear in the future, I'll update the docs. For now I hope the table at the following link will suffice.
https://github.com/peter-evans/slash-command-dispatch/tree/dev#dispatch-type

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see, thx for this insights.

Copy link
Contributor

@clxmstaab clxmstaab left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

left a few more notes.

the docs area already very good - you have done a great job.

really appreciate your efforts. thanks!

README.md Outdated Show resolved Hide resolved
peter-evans and others added 3 commits July 24, 2020 17:52
Co-authored-by: Markus Staab <47448731+clxmstaab@users.noreply.github.com>
@peter-evans peter-evans merged commit d09e9c6 into master Jul 25, 2020
@peter-evans peter-evans deleted the dev branch July 25, 2020 04:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

client_payload is too large
2 participants