docs: Add team assignment

[zkoppert]

fixes #52

[julioz]

Thanks. An important part we're missing here is that the GitHub Action machine account must have the permissions to read the organizations' teams and their members. Without it, jq will take an empty list as input (gh api outputs nothing to stdout).

[zkoppert]

@julioz I don't see organization team members as an option in the list of permissions to assign. Do you know how to assign this? Maybe we need a step to use a custom token to auth into the gh api tool. I can ask around here as well.

[julioz]

Yep precisely, the token needs to be generated with these permissions and set as a repository secret.

[zkoppert]

I see now, we should just change GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} to be GITHUB_TOKEN: ${{ secrets.CUSTOM_API_TOKEN }} and give instructions for how to create a token and what permissions. I'll work on that.

[zkoppert]

#64 to update the documentation. Thanks for the heads up on this! Feel free to review the PR.