Archive repositories do not return draft releases

[frankmalin]

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/releases/releases?apiVersion=2022-11-28#list-releases
https://docs.github.com/en/enterprise-cloud@latest/rest/releases/releases?apiVersion=2022-11-28#list-releases
https://docs.github.com/en/enterprise-server@3.19/rest/releases/releases?apiVersion=2022-11-28#list-releases

What changes are you suggesting?

Documentation States:

Information about published releases are available to everyone. Only users with push access will receive listings for draft releases.

Requested Change:

Information about published releases are available to everyone. Only users with push access will receive listings for draft releases. Repositories in an archived state do not return draft releases.

API behavior:
The rest call will not return draft releases for archived repositories.

Issue:
When writing a comparison function to verify that repositories migrated from one org to another failed comparison to check the release artifacts, since one repository had been archived.

The documentation should support the behavior of the API.

Additional information

Steps to reproduce:

• Migrate repository using gh gei from src to dst org
• add step to migration process to pull published and draft releases to dst org
• Archive repository in the src org
• Run post migration step to ensure :
  • compare issues migrated
  • compare branch/sha
  • compare release artifacts
    The release artifacts compare fails, since the repository in the src org had been archived.

[Sharra-writes]

@frankmalin Thanks for bringing this to our attention! I'm going to check in and make sure this isn't a bug, and I'll let you know what I find out.

Edit after looking at the PR: we're probably going to have to fix the documentation internally if it's not a bug. Not all files can be edited from this repository, and this is one of the ones that's off-limits for open source contributions.

[github-actions]

A stale label has been added to this issue, because it has been open for 30 days with no activity. If you think this issue should remain open, please add a new comment.

[github-actions]

A stale label has been added to this issue, because it has been open for 30 days with no activity. If you think this issue should remain open, please add a new comment.