Metadata question

首先审查 OpenAPI 元数据以及 issue 中列出的五个 ActionsService 方法，然后将它们与 GHES v3.7 文档和 #4335 中提出的修复进行比较。完成的标准是回答有关移除和弃用 endpoint 的问题，并记录更新受影响函数的明确流程。

I happened to be re-implementing some acceptance tests the other day and while doing so I noticed that the signatures for the actions secret functions didn't look right. Tracking this back into the OpenAPI doc shows that the 5 functions below are tracking APIs from GHES v3.7 that are no longer documented (see #4335 for my proposed fix for this specific case).

• ActionsService.GetEnvPublicKey
• ActionsService.ListEnvSecrets
• ActionsService.GetEnvSecret
• ActionsService.CreateOrUpdateEnvSecret
• ActionsService.DeleteEnvSecret

Looking at the OpenAPI metadata I was expecting these endpoints to be marked as deprecated, but this doesn't appear to be the case. I can also see unused endpoints from old GHES versions still in the metadata.

My primary questions are as follows:

• Should endpoints be removed once they're no longer supported by GitHub and are no longer in use (e.g. there are some projects v1 endpoints still in there)?
• Should endpoints be marked as deprecated once they're no longer supported by GitHub (e.g. deprecated or not in supported GHES versions)?
• If the endpoints were correctly marked as deprecated would this automatically mark the functions as deprecated?
  • If this is the case do we have a process for updating functions that just need to change endpoint and/or signature?