When transferring ownership of a repository from Hashgraph to Hiero-Ledger in Github the steps outlined below must be completed
- Repository Transfer Agent (TA)
- The person responsible for transferring the repository
- Must have ability to create a repository on the receiving organizations side (Hiero)
- Repository Transfer Approval Agent (AA)
- The person responsible for approving PRs throughout the transfer process
- Must have approval authority on the Hiero-Ledger/governance repository and on the target repository
Prior to the day of transfer the following items shall be defined and made available to the Repository Transfer Agent
- Target Repository Name (like hiero-sdk-foo)
- Maintainer Group Name (like hiero-sdk-foo-maintainer)
- Maintainers List (should be 2-3 people)
- Committer Group Name (like hiero-sdk-foo-commiter)
- Committers List
Throughout the transfer process both TA and AA shall be available.
The following steps shall occur to transfer a repository into Hiero from a source organization
- The TA will generate a pull request in the Hiero-Ledger Governance repository
- The TA will modify the
config.yaml
file in this repository with the following information- The new maintainer group name (
REPO-maintainers
) - The new maintainers for the group
- The new committer group name (
REPO-committers
) - the new set of committers for that group
- The new repository to pull in
- The
tsc
group should have theadmin
role on the repository - The
github-maintainers
group should have theadmin
role on the repository - The
github-committers
group should have thewrite
role on the repository. - The
REPO-maintainers
group should have themaintain
role on the repository. - The
REPO-committers
group should have thewrite
role on the repository.
- The new maintainer group name (
- The TA will modify the
- The AA will approve the changes in
Hiero-Ledger/governance
- The TA will transfer the repository from the source organization into Hiero
- The TA will assign the
Target Repository Name
to the repo upon transfer
- The TA will assign the
- The TA will assign the
Target Repository
to the appropriate github self-hosted runner group - The TA will open a PR on the
Target Repository
- The TA will modify the self-hosted runner labels in the github actions
- Note: This will enable the repository actions to run after transfer
- The TA will modify the self-hosted runner labels in the github actions
- The AA will approve the PR on the
Target Repository
- The AA will set the "Social preview" in the repository settings to https://github.com/hiero-ledger/.github/blob/main/resources/social-media-template.png
At this point the repository is considered transferred.
After the repository is transferred the maintainers and committers shall ensure the repository behaves as expected and will triage and solve any immediate issues