Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
alstr authored May 31, 2020
1 parent 4ed02ed commit 5d27a9a
Showing 1 changed file with 16 additions and 9 deletions.
25 changes: 16 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Create a workflow file in your .github/workflows directory as follows:

### workflow.yaml

Latest version is `v1.1.2-beta`.
Latest version is `v1.2-beta`.

name: "Workflow"
on: ["push"]
Expand All @@ -25,7 +25,7 @@ Latest version is `v1.1.2-beta`.
steps:
- uses: "actions/checkout@master"
- name: "TODO to Issue"
uses: "alstr/todo-to-issue-action@v1.1.2-beta"
uses: "alstr/[email protected]"
with:
REPO: ${{ github.repository }}
BEFORE: ${{ github.event.before }}
Expand Down Expand Up @@ -58,12 +58,14 @@ Latest version is `v1.1.2-beta`.
This will create an issue called "Come up with a more imaginative greeting".

**The action expects a space and/or colon to follow the `TODO` label.**
**The action expects a colon and/or space to follow the `TODO` label (so `TODO: ` or just `TODO`).**

Should the title be longer than 50 characters, it will be truncated for the issue title.

The full title will be included in the issue body and a `todo` label will be attached to the issue.

A reference hash is added to the end of the issue body. This is to help prevent duplication of TODOs.

### Multiline TODOs

def hello_world():
Expand All @@ -82,7 +84,7 @@ The `COMMENT_MARKER` input must be set to the correct syntax (e.g. `#` for Pytho
def hello_world():
print('Hello world!')

Removing the `# TODO` comment will close the issue on push.
Removing the `# TODO` comment will close the issue on push. This is still an experimental feature.

### Updating TODOs

Expand All @@ -94,12 +96,17 @@ Should you change the `# TODO` text, this will currently create a new issue, so

This may be updated in future.

## Thanks
## Contributing & Issues

The action was developed for the GitHub Hackathon and is still in an early stage. Whilst every effort is made to ensure it works, it comes with no guarantee.

Thanks to Jacob Tomlinson for his handy overview of GitHub Actions:
It may not yet work for [ events ](https://help.github.com/en/actions/reference/events-that-trigger-workflows) other than `push` or those with a complex [ workflow syntax ](https://help.github.com/en/actions/reference/workflow-syntax-for-github-actions).

https://www.jacobtomlinson.co.uk/posts/2019/creating-github-actions-in-python/
If you do encounter any problems, please file an issue. PRs are welcome and appreciated!

## Thanks

Thanks to GitHub's [linguist repo](https://github.com/github/linguist/) for the handy `languages.yml` file used by the app to determine the correct highlighting to apply to code snippets:
Thanks to Jacob Tomlinson for [ his handy overview of GitHub Actions ](https://www.jacobtomlinson.co.uk/posts/2019/creating-github-actions-in-python/).

https://raw.githubusercontent.com/github/linguist/master/lib/linguist/languages.yml
Thanks to GitHub's [linguist repo](https://github.com/github/linguist/) for the [ `languages.yml` ](
https://raw.githubusercontent.com/github/linguist/master/lib/linguist/languages.yml) file used by the app to determine the correct highlighting to apply to code snippets.

0 comments on commit 5d27a9a

Please sign in to comment.