Skip to content

docs: make it clearer how the action is used#31

Merged
EndBug merged 3 commits intoEndBug:masterfrom
adamkudrna:feature/improve-docs
Dec 5, 2020
Merged

docs: make it clearer how the action is used#31
EndBug merged 3 commits intoEndBug:masterfrom
adamkudrna:feature/improve-docs

Conversation

@adamkudrna
Copy link
Copy Markdown
Contributor

Hello! I've just spent a couple of hours figuring out why this action doesn't work in my workflow despite it had worked before. Then I realized I didn't include new version number in my commit message this time. So I'm trying to improve the docs a bit to clearly say how the action should be used.

Furthermore, I believe that enum-type options (assume-same-version and static-checking) should have defaults other than ''. It's confusing to read that accepted values are old or new while the default is ''. I didn't edit this as it probably requires code changes as well.

Comment thread README.md Outdated
static-checking: localIsNew
```

Now, when someone changes the version in `package.json` to `1.2.3` and pushes a commit with the message `<WHATEVER> 1.2.3` (eg. `Release 1.2.3` or `Bump version to v1.2.3`), output values are set (see Outputs below). Otherwise, no output is provided.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Otherwise, no output is provided.

Relates to #30.

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

I'll solve issue #30 before merging this PR

Copy link
Copy Markdown
Owner

@EndBug EndBug left a comment

Choose a reason for hiding this comment

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

Hi, thanks for the PR! I've left a couple of comments, could you take a look at them?

Comment thread README.md Outdated
You have to set up a step like this in your workflow (this assumes you've already [checked out](https://github.com/actions/checkout) your repo and [set up Node](https://github.com/actions/setup-node)):
### GitHub Workflow

You have to set up a step like this in your GitHub workflow file (eg. `.github/workflows/release-management.yml`), assuming you've already [checked out](https://github.com/actions/checkout) your repo:
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

I get that you want to use as an example of where to find a workflow file, but I think that it seems like you're referring to a file in my repo. Could you rephrase this?

Comment thread README.md Outdated
Comment thread README.md Outdated
static-checking: localIsNew
```

Now, when someone changes the version in `package.json` to `1.2.3` and pushes a commit with the message `<WHATEVER> 1.2.3` (eg. `Release 1.2.3` or `Bump version to v1.2.3`), output values are set (see Outputs below). Otherwise, no output is provided.
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

I'll solve issue #30 before merging this PR

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Dec 2, 2020

This PR is being marked as "stale" because it has been open 20 days with no activity. Remove the "stale" label or comment, otherwise this will be closed in 5 days.

@github-actions github-actions Bot added the status: stale Inactive issues and PRs label Dec 2, 2020
@EndBug EndBug removed the status: stale Inactive issues and PRs label Dec 3, 2020
@EndBug EndBug merged commit 2c336e6 into EndBug:master Dec 5, 2020
@adamkudrna
Copy link
Copy Markdown
Contributor Author

@EndBug Thank you for finishing the work! Unfortunately I didn't get back to it until now…

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.

2 participants