Inconsistent parameter naming: tag, tag_name

[Richienb]

Checklist

• I checked all open bugs and none of them matched my problem.

Versions

+-- @octokit/rest@18.0.6
| +-- @octokit/core@3.2.0
| | +-- @octokit/auth-token@2.4.2
| | +-- @octokit/graphql@4.5.6
| | +-- @octokit/request@5.4.9
| | | +-- @octokit/endpoint@6.0.8
| | | +-- @octokit/request-error@2.0.2
| | +-- @octokit/types@5.5.0
| +-- @octokit/plugin-paginate-rest@2.4.0
| +-- @octokit/plugin-request-log@1.0.2
| `-- @octokit/plugin-rest-endpoint-methods@4.2.0

What happened?

octokit.repos.createRelease uses tag_name but octokit.repos.getReleaseByTag uses tag.

What did you expect to happen?

They should be consistently named.

[gr2m]

I'm afraid I cannot help with that. The methods are a 1:1 mapping of GitHub's REST API, with all its little flaws. See

• https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#create-a-release
• https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#get-a-release-by-tag-name

It might be worth renaming the URL parameters. We did that in the past in order to make the REST API more coherent. That would need to be fixed in https://github.com/github/rest-api-description/, both the docs and the Octokit SDKs are generated from it. Would you like to file an issue there? No worries if not, I'll look into it eventually

[oscard0m]

github/rest-api-description#182