Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dime-worldbank/dime-account-admin

Starting point for instructions and resources related to DIME GitHub account.
https://github.com/dime-worldbank/dime-account-admin

Last synced: about 1 month ago
JSON representation

Starting point for instructions and resources related to DIME GitHub account.

Awesome Lists containing this project

README

        

# DIME GitHub Account Guidelines

#### Git/GitHub trainings resources

This repo includes instructions related to DIME's GitHub account.
For Git/GitHub trainings and DIME Analytics other
Git/GitHub resources see here see
[here](https://osf.io/e54gy/)
and/or [here](https://github.com/worldbank/dime-github-trainings).

### Actions for the DIME Account:
These instructions applies to repos with URLs starting with:
https://github.com/dime-worldbank.
Read more about why we use multiple accounts [here](./resources/why-multiple-accounts.md).

* **Request to become DIME account member**
* [DIME user](#dime-account-request-membership)
* External Collaborator - see DIME Member for exceptions
* **Give user access to DIME account repo**
* [DIME account member](#dime-account-repo-access)
* [External collaborator](#dime-account-repo-access)
* **Repo creation on the DIME account**
* [DIME account member - request new repo](#dime-account-repo-creation)

### Actions for the WB Account:
These instructions applies to repos with URLs starting with:
https://github.com/worldbank.
Read more about why we use multiple accounts [here](./resources/why-multiple-accounts.md).

* **Request to become WB account member**
* [WB user](#wb-account-request-membership)
* **Give user access to WB account repo**
* [WB account member](#wb-account-repo-access)
* [External Collaborator](#wb-account-repo-access)
* **Repo creation on the WB account**
* [DIME member - request new repo](#wb-account-repo-creation)

### General GitHub Actions:

* **Change name of a GitHub repository**
* [Request repository name change](./instructions/request-name-change.md)

### Other accounts

DIME Analytics can provide general advice for
DIME repos hosted on other accounts.
For example accounts owned by external collaborators the project work with.
But since DIME Analytics do not have admin rights on those repos,
there are no specific guidelines for such repos.

### Why add DIME users as members first?

Users with an active contract with DIME ("_DIME users_")
should be added as members of
the https://github.com/dime-worldbank account ("_DIME account members_").
Adding DIME users as account members has these advantages:

* Project teams can give and revoke access to their repos when DIME users join or leave the team without having to involve DIME Analytics
* Collaboration across teams is easier as other DIME users can
quickly be given access to repos without having to involve DIME Analytics
* This provides a way to manage access to content
on the DIME account to DIME members only.

## DIME Account

These instructions applies to repos with URLs starting with:
https://github.com/dime-worldbank.

### DIME Account: Request membership

* **DIME users:** [eServices request](https://worldbankgroup.service-now.com/wbg?id=wbg_sc_catalog&sys_id=910e1739db1a54903c5960ab13961912) (_WB intranet access only - if you do not have access to the eServices portal someone else can make the request on your behalf_)
* **WB non-DIME users:** If you have an active WB contract and work on a portfolio of DIME projects you may still be added as a member. Discuss with your DIME contact and then submit the request for DIME users and list the DIME contact in the request when asked to.
* **External users**: External users are only given access on per repo basis. See repo access section below.

**_Quick notes:_**
* You must have a YubiKey or a WB computer to be able to access the WB account as a member. WB users without this can still be added as external users.
* Joining the WB account do not by itself give access to any repo hosted there

_See pages with instructions for more details._

### DIME Account: Repo access

* **DIME account members:** [Add DIME account member to team](https://github.com/dime-worldbank/dime-account-admin-private/blob/main/instructions/dime-repo-access-member.md). (_DIME account member access only - see [here](./resources/dime-only-resources.md) if link does not work_)
* **External collaborators:** [Request access to repo on behalf of external collaborator](https://github.com/dime-worldbank/dime-account-admin-private/blob/main/instructions/dime-repo-access-external.md). (_DIME account member access only - see [here](./resources/dime-only-resources.md) if link does not work_)

**_Quick notes:_**
* Users who already are members of the DIME account (see above how to become a member) are given access to the repo by adding them to the GitHub team used for that repo.
* The maintainer of the GitHub team can add DIME account members to the team without involving DIME Analytics. (DIME Analytics can help but will reach out to maintainer for approval.)
* To see who is maintainer of a GitHub team,
see the [team reports](https://github.com/dime-worldbank/dime-account-admin-private/tree/main/reports/team-reports).
To see what GitHub team is used for a repo,
see the [repo reports](https://github.com/dime-worldbank/dime-account-admin-private/tree/main/reports/repo-reports).
(_DIME account member access only - see [here](./resources/dime-only-resources.md) if link does not work_)
* External collaborators are not added to the DIME account and can therefore not be added to GitHub teams. Instead, external collaborators are added to individual repos.
* The request to add external collaborators to a repo should be sent to DIME Analytics by a person at DIME.

_See pages with instructions for more details._

### DIME Account: Repo creation

* [Repo creation instructions](https://github.com/dime-worldbank/dime-account-admin-private/blob/main/instructions/dime-create-repo.md). (_DIME account member access only - see [here](./resources/dime-only-resources.md) if link does not work_)

**_Quick notes:_**
* The request to create a new repo can be sent by anyone in DIME (does not need to be a member of the DIME account or even have a GitHub account)
* The request to create a new repo needs to be approved by a DIME manager

_See pages with instructions for more details._

## WB Account

These instructions applies to repos with URLs starting with:
https://github.com/worldbank.

### WB Account: Request membership

* **WB users:** [eServices request](https://worldbankgroup.service-now.com/wbg?id=wbg_sc_catalog&sys_id=910e1739db1a54903c5960ab13961912) (_WB intranet access only - if you do not have access to the eServices portal someone else can make the request on your behalf_)
* **External users**: External users are only given access on per repo basis. See repo access section below.

**_Quick notes:_**
* You must have a YubiKey or a WB computer to be able to access the WB account as a member. WB users without this can still be added as external users.
* Anyone with an active WB contract and a GitHub account can use the eServices request to join the WB account
* Joining the WB account do not by itself give access to any repo hosted there

_See pages with instructions for more details._

### WB Account: Repo access

* **WB account member:** [Add WB account member to team](https://github.com/dime-worldbank/dime-account-admin-private/blob/main/instructions/wb-repo-access-member.md). (_DIME account member access only - see [here](./resources/dime-only-resources.md) if link does not work_)
* **External collaborators:** [Request access to repo on behalf of external collaborator](https://github.com/dime-worldbank/dime-account-admin-private/blob/main/instructions/wb-repo-access-external.md). (_DIME account member access only - see [here](./resources/dime-only-resources.md) if link does not work_)

**_Quick notes:_**
* Similarly to the DIME account, WB account members are given access to repos through maintainers adding them to GitHub teams on the WB account.
* GitHub teams on the DIME account cannot be used for repos on the WB account
* DIME Analytics does not generate repo and team reports
(i.e. [these](https://github.com/dime-worldbank/dime-account-admin-private/tree/main/reports)) for the WB account.
Instead, browse this page https://github.com/orgs/worldbank/teams (_WB account member access only_) to find which team is used for which repo.
* External collaborators are not added to the DIME account and can therefore not be added to GitHub teams. Instead, external collaborators are added to individual repos.
* The request to add external collaborators to a repo should be sent to DIME Analytics by a person at DIME.

_See pages with instructions for more details._

### WB Account: Repo creation

* [Repo creation instructions](https://github.com/dime-worldbank/dime-account-admin-private/blob/main/instructions/wb-create-repo.md). (_DIME account member access only - see [here](./resources/dime-only-resources.md) if link does not work_)

**_Quick notes:_**
* Most repos should be created on the DIME account, but reach out to DIME Analytics if you think your repo should be hosted on the WB account
* The request to create a new repo can be sent by anyone in DIME (does not need to be a member of the DIME account or even have a GitHub account)
* The request to create a new repo needs to be approved by a DIME manager

_See pages with instructions for more details._