If you're using use-herald-action
in a private organization, you'll need to follow additional
instructions to set up and install a GitHub App in your organization.
This app itself doesn't actually do anything. It exists only so that we can generate a client secret with
permissions that enable use-herald-action
to do things like
mention private teams and team members within your organization.
Determine the name of the organization in which you want to set up this app by going to
Settings > Organizations
in the GitHub UI.
At the bottom of this page, you'll be able to enter the name of your organization to kick off the setup flow.
Once you've submitted your organization name, you'll be redirected to GitHub.
There, you might be asked to provide your password to verify that it's actually you.
Here, we've filled in the app name for you with [<org-name>] Use Herald Action App
.
Of course, you have the option to name it whatever you like, as long as it's unique.
GitHub will let you know if another app has the same name as what you want.
Look out for the error message:
You don't have permission to create apps for <org-name>. You may still create this app for your
own account.
If this happens, double check that you both spelled your organization correctly and have the necessary permissions to install apps in your organization.
If all goes well, you should be directed to a set of post-setup instructions.