docs icon indicating copy to clipboard operation
docs copied to clipboard

Clarify that workflows can be reused within an org's private repo with appropriate settings

Open TannerPerrien opened this issue 3 years ago • 3 comments

Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/actions/using-workflows/reusing-workflows

What changes are you suggesting?

The current docs are misleading in suggesting the following:

A reusable workflow can be used by another workflow if either of the following is true:

  • Both workflows are in the same repository.
  • The called workflow is stored in a public repository, and your organization allows you to use public reusable workflows.

Source: https://docs.github.com/en/actions/using-workflows/reusing-workflows#access-to-reusable-workflows

Additional information

Go to a repository's Settings > Actions > General > [Bottom of page] Access -> Accessible from repositories in the 'XYZ' organization

So long as this access level is chosen, workflows in this private repo can be reused in other private repos own by the same org.

TannerPerrien avatar Dec 03 '22 06:12 TannerPerrien

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.

welcome[bot] avatar Dec 03 '22 06:12 welcome[bot]

This may be covered in the enterprise docs. However, I am able to set access permissions with a GitHub Team plan, so I still think the docs should receive some kind of update.

TannerPerrien avatar Dec 03 '22 06:12 TannerPerrien

@TannerPerrien Thanks for opening an issue and submitting a PR ✨

cmwilson21 avatar Dec 05 '22 14:12 cmwilson21

Thanks a lot for the issue and PR, @TannerPerrien!

This product change is still in the process of being fully rolled out, and we do have docs ready to go internally that will cover it. At the moment, we expect the official docs and announcement will be released publicly sometime next week.

Sorry for the confusion 🙇‍♂️

lucascosti avatar Dec 07 '22 05:12 lucascosti

That's great news! Thanks!

TannerPerrien avatar Dec 07 '22 13:12 TannerPerrien