Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[REST] create-an-attestation should mention that private repositories need to be owned by enterprises #35835

Open
1 task done
jsoref opened this issue Jan 6, 2025 · 3 comments
Labels
content This issue or pull request belongs to the Docs Content team needs SME This proposal needs review from a subject matter expert rest Content related to rest - overview. waiting for review Issue/PR is waiting for a writer's review

Comments

@jsoref
Copy link
Contributor

jsoref commented Jan 6, 2025

Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/rest/repos/repos?apiVersion=2022-11-28#create-an-attestation

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

Restructure this sentence:

The authenticated user must have write permission to the repository and, if using a fine-grained access token, the attestations:write permission is required.

Something like this might work:

  • The authenticated user must have write permission to the repository.
  • If the repository is private, it must be owned by an enterprise.
  • If using a fine-grained access token, the attestations:write permission is required.

Additional information

@jsoref jsoref added the content This issue or pull request belongs to the Docs Content team label Jan 6, 2025
@github-actions github-actions bot added the triage Do not begin working on this issue until triaged by the team label Jan 6, 2025
@jsoref
Copy link
Contributor Author

jsoref commented Jan 6, 2025

This documentation is reached from errors like this:
https://github.com/check-spelling-sandbox/gh-foorbar/actions/runs/12626392159/attempts/1

Error: Failed to persist attestation: Feature not available for the check-spelling-sandbox organization. To enable this feature, please upgrade the billing plan, or make this repository public. - https://docs.github.com/rest/repos/repos#create-an-attestation

@nguyenalex836 nguyenalex836 added waiting for review Issue/PR is waiting for a writer's review rest Content related to rest - overview. and removed triage Do not begin working on this issue until triaged by the team labels Jan 6, 2025
@nguyenalex836
Copy link
Contributor

@jsoref Thank you for raising this issue and providing all of that context! I'll get this triaged for review ✨ Our team will provide feedback regarding the best next steps for this issue - thanks for your patience! 💛

@subatoi subatoi added the needs SME This proposal needs review from a subject matter expert label Jan 7, 2025
Copy link
Contributor

github-actions bot commented Jan 7, 2025

Thanks for opening an issue! We've triaged this issue for technical review by a subject matter expert 👀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content This issue or pull request belongs to the Docs Content team needs SME This proposal needs review from a subject matter expert rest Content related to rest - overview. waiting for review Issue/PR is waiting for a writer's review
Projects
None yet
Development

No branches or pull requests

3 participants