`state_reason` missing from rest api issue docs

[tjenkinson]

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://octokit.github.io/rest.js/v18#issues-update https://docs.github.com/en/rest/issues/issues#update-an-issue and probably some of the other issue entries too.

What part(s) of the article would you like to see updated?

state_reason mentioned in https://github.blog/changelog/2022-05-19-the-new-github-issues-may-19th-update/ should be documented.

refs probot/stale#379
refs actions/stale#744

Additional information

It looks like it's actually there but not sure why it's not ended up in the generated page?

"state_reason": {
  "description": "The reason for the current state",
  "type": [
    "string",
    "null"
  ],
  "examples": [
    "not_planned"
  ]
}

is in lib/rest/static/decorated/api.github.com.json.

[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]

@tjenkinson Thanks so much for opening an issue! I'll triage this for the team to take a look 👀

[janiceilene]

👋 @tjenkinson If I'm understanding correctly, you're looking to update the Octokit docs, which we don't own. You can open an issue in https://github.com/octokit to request an Octokit update.

It looks like we document this feature in https://docs.github.com/en/issues/tracking-your-work-with-issues/closing-an-issue on the GitHub Docs. I'm going to close this now, but please let me know if I'm misunderstanding your request 💛

Thanks so much for your interest and passion in improving the GitHub Docs ⚡

[tjenkinson]

Ah @janiceilene I put the wrong link. I meant https://docs.github.com/en/rest/issues/issues#update-an-issue

Looks like an issue should be opened on octokit too though (although I think that might scrape these docs)

[janiceilene]

That makes sense! Thanks for the clarification @tjenkinson I'll put this back on the review board for our rest folks to check out 💖