Thanks for pointing that out,@fixe! ⚡

This might just be a bad example (possibly here from a previous version of the API). I wouldn't say that PUT is used for custom actions -- a POST method is almost always used for that (not just in the GitHub API). A better example for this might berendering a Markdown document ormerging branches.

What do you think,@pengwynn@jasonrudolph?

@izuzakstarring a repository is also done with aPUT:

PUT /gists/:id/star

I think we can just drop the "and performing custom actions (such as merging a pull request)." part.

In both themerge andstar examples, those aren't verbs, they're nouns. You're creating a merge or creating a star, and there can only be one at that resource location.

@pengwynn PR updated.

🍰