mirror of
https://github.com/peter-evans/create-or-update-comment.git
synced 2025-02-23 04:50:11 +08:00
Update README
This commit is contained in:
parent
cbecc49094
commit
03a4ec0930
71
README.md
71
README.md
@ -1,2 +1,69 @@
|
||||
# create-or-update-comment
|
||||
A GitHub action to create or update an issue or pull request comment
|
||||
# Create or Update Comment
|
||||
[](https://github.com/marketplace/actions/create-or-update-comment)
|
||||
|
||||
A GitHub action to create or update an issue or pull request comment.
|
||||
|
||||
This action was created to help facilitate a GitHub Actions "ChatOps" solution in conjunction with [slash-command-dispatch](https://github.com/peter-evans/slash-command-dispatch) action.
|
||||
|
||||
## Usage
|
||||
|
||||
### Add a comment to an issue or pull request
|
||||
|
||||
```yml
|
||||
- name: Create comment
|
||||
uses: peter-evans/create-or-update-comment@v1
|
||||
with:
|
||||
token: ${{ secrets.GITHUB_TOKEN }}
|
||||
issue-number: 1
|
||||
body: |
|
||||
This is a multi-line test comment
|
||||
- With GitHub **Markdown**
|
||||
- Created by [create-or-update-comment][1]
|
||||
|
||||
[1]: https://github.com/peter-evans/create-or-update-comment
|
||||
reaction-type: +1
|
||||
```
|
||||
|
||||
### Update a comment
|
||||
|
||||
```yml
|
||||
- name: Update comment
|
||||
uses: peter-evans/create-or-update-comment@v1
|
||||
with:
|
||||
token: ${{ secrets.GITHUB_TOKEN }}
|
||||
comment-id: 557858210
|
||||
body: |
|
||||
**Edit:** Some additional info
|
||||
reaction-type: eyes
|
||||
```
|
||||
|
||||
### Add a comment reaction
|
||||
|
||||
```yml
|
||||
- name: Add reaction
|
||||
uses: peter-evans/create-or-update-comment@v1
|
||||
with:
|
||||
token: ${{ secrets.GITHUB_TOKEN }}
|
||||
comment-id: 557858210
|
||||
reaction-type: heart
|
||||
```
|
||||
|
||||
### Action inputs
|
||||
|
||||
| Name | Description | Default |
|
||||
| --- | --- | --- |
|
||||
| `repository` | The full name of the repository in which to create or update a comment. | Current repository |
|
||||
| `issue-number` | The number of the issue or pull request in which to create a comment. | |
|
||||
| `comment-id` | The id of the comment to update. | |
|
||||
| `body` | The comment body. | |
|
||||
| `edit-mode` | The mode when updating a comment, `replace` or `append`. | `append` |
|
||||
| `reaction-type` | The reaction to add to the comment. (`+1`, `-1`, `laugh`, `confused`, `heart`, `hooray`, `rocket`, `eyes`) | |
|
||||
|
||||
### Accessing issues and comments in other repositories
|
||||
|
||||
You can create and update comments in another repository by using a [PAT](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line) instead of `GITHUB_TOKEN`.
|
||||
The user associated with the PAT must have write access to the repository.
|
||||
|
||||
## License
|
||||
|
||||
[MIT](LICENSE)
|
||||
|
Loading…
x
Reference in New Issue
Block a user