mercy preview not mentioned for repository REST endpoints

[vbatts]

What article on docs.github.com is affected?

https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#list-organization-repositories
Returns a listing of repositories for an org/user. The example shown in the docs displays a "topics" key in the data, but does not show up when making the actual API call

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

Ideally the "topics" data would be added to the actual API, like the docs describe...

Additional information

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

[lucascosti]

Thanks for opening this, @vbatts! I'm not sure if this is an API bug or an error in our docs. I'll check with our engineering team to make sure. 👍

[vbatts]

@lucascosti thanks!

[lucascosti]

@vbatts I've chased this up with engineering, and the topics key in repository responses are currently behind a preview that is not currently documented for that particular endpoint.

To get topics in the response, you can pass application/vnd.github.mercy-preview+json in the accept header (similar to the 'Get all repository topics' endpoint).

I'll retitle this PR, so we can add information about the preview to the docs; this will need to be done internally because the API docs are generated from the source code.

[lucascosti]

Note for whomever picks this up: this probably affects most repository endpoints (i.e. most create/update/list repo endpoints).

[jmarlena]

Heads up someone else opened an issue for this in https://github.com/github/docs-content/issues/4296.

[docubot]

Thank you for opening this issue! Changes to the REST API schema can be requested in github/rest-api-description. I will transfer your issue over to that open source repo.

[jpcmonster]

I am still seeing topics as an element in the sample response in the docs, e.g. here:
https://docs.github.com/en/enterprise-server@3.4/rest/repos/repos#list-organization-repositories
However, I do not think there is a topics element present in GHE 3.4 responses... right?

    "is_template": false,
    "topics": [
      "octocat",
      "atom",
      "electron",
      "api"
    ],
    "has_issues": true,