Wrong documentation for "since" param in REST API documentation

[kartben]

Code of Conduct

• I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

• https://docs.github.com/en/rest/apps/apps?apiVersion=2022-11-28#list-installations-for-the-authenticated-app
• https://docs.github.com/en/rest/issues/issues?apiVersion=2022-11-28#list-issues-assigned-to-the-authenticated-user
• https://docs.github.com/en/rest/issues/issues?apiVersion=2022-11-28#list-organization-issues-assigned-to-the-authenticated-user
• https://docs.github.com/en/rest/issues/issues?apiVersion=2022-11-28#list-repository-issues
• https://docs.github.com/en/rest/issues/issues?apiVersion=2022-11-28#list-user-account-issues-assigned-to-the-authenticated-user
• https://docs.github.com/en/rest/commits/commits?apiVersion=2022-11-28#list-commits
• https://docs.github.com/en/rest/gists/gists?apiVersion=2022-11-28#list-gists-for-the-authenticated-user
• https://docs.github.com/en/rest/gists/gists?apiVersion=2022-11-28#list-public-gists
• https://docs.github.com/en/rest/gists/gists?apiVersion=2022-11-28#list-starred-gists
• https://docs.github.com/en/rest/gists/gists?apiVersion=2022-11-28#list-gists-for-a-user
• https://docs.github.com/en/rest/issues/comments?apiVersion=2022-11-28#list-issue-comments-for-a-repository
• https://docs.github.com/en/rest/issues/comments?apiVersion=2022-11-28#list-issue-comments
• https://docs.github.com/en/rest/pulls/comments?apiVersion=2022-11-28#list-review-comments-in-a-repository
• https://docs.github.com/en/rest/pulls/comments?apiVersion=2022-11-28#list-review-comments-on-a-pull-request

What changes are you suggesting?

All/most of the API methods that accept a since param seem to say: "Only show notifications updated after the given time. [...]", even for issues, app installations, gists, etc.

Interestingly, https://docs.github.com/en/rest/repos/repos?apiVersion=2022-11-28#list-repositories-for-the-authenticated-user seem to be the only one (except for /notifications of course) being correct.

Additional information

No response

[welcome]

Thanks for opening this issue. A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

[cmwilson21]

@kartben Thanks for opening an issue! However, REST API docs are handled in a separate repo, so I'm going to transfer this issue there.

Thank you for your interest in improving GitHub Docs! 💖

[docubot]

Thank you for opening this issue! Updates to the REST API, GraphQL API, and webhook reference documentation must be made internally. I have copied your issue to an internal issue, so I will close this issue.

[jhosman]

👋 @kartben - Do you mean that the since parameter isn't working for you when you make API calls with those endpoints? I tested a few, and it seems to be working for me. Could you provide specific examples of the problem you're seeing? Thanks!

[kartben]

Hi! No I am only talking about the typo / copy-paste error in the text of the parameter's documentation -- the param doc for all the cited methods say "... notifications updated ..." where they should instead say "… issues updated ...", "... pull requests updated ..." etc. Thanks!

[jhosman]

Ahhh, yes, I see what you mean! Thanks for the clarification @kartben - We'll get this fixed internally 🌟