Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add gh enterprise early access program details with policy #751

Merged
merged 6 commits into from
Mar 5, 2024
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion _data/navigation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
url: /collaboration/cmi-rse
- title: Testimonials
url: /collaboration/testimonials
- title: "Training"
- title: "Training & Resources"
subitems:
- title: Training Courses
url: /training/
Expand All @@ -28,6 +28,8 @@
url: /support/code-clinic
- title: "COM4521/COM6521: Parallel Computing with GPUs"
url: /training/com4521
- title: "Github Enterprise Early Access Program"
url: /training/github-enterprise
- title: Our Community
subitems:
- title: Overview
Expand Down
76 changes: 76 additions & 0 deletions pages/training/gh-enterprise.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
title: Github Enterprise Early Access Program
permalink: /training/github-enterprise/
slug: github-enterprise
type: text
---

In collaboration with IT Services, the RSE team is providing limited early access to the University's Github Enterprise. This is to allow researchers and academics to get the full [benefits of Github Enterprise](https://docs.github.com/en/get-started/learning-about-github/githubs-plans) now while allowing us to obtain feedback which will be used to refine the service offering in the eventual university-wide rollout.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps link directly to the section on GitHub Enterprise.

Suggested change
In collaboration with IT Services, the RSE team is providing limited early access to the University's Github Enterprise. This is to allow researchers and academics to get the full [benefits of Github Enterprise](https://docs.github.com/en/get-started/learning-about-github/githubs-plans) now while allowing us to obtain feedback which will be used to refine the service offering in the eventual university-wide rollout.
In collaboration with IT Services, the RSE team is providing limited early access to the University's Github Enterprise. This is to allow researchers and academics to get the full [benefits of Github Enterprise](https://docs.github.com/en/get-started/learning-about-github/githubs-plans#github-enterprise) now while allowing us to obtain feedback which will be used to refine the service offering in the eventual university-wide rollout.


If you would like to be a part of this program, please read through the access policy below and apply using the button at the bottom of the page.

## 1. UoS Github Enterprise Early Access policy

### 1.1 Eligibility

#### 1.1.1 General Access
To encourage sharing and collaboration, with permission of the Github Organisation owner, there are no restrictions on who can be allowed access to repositories (have read and write permission) under UoS Github Enterprise. Anyone that is not a member of UoS should be marked as an external collaborator.

#### 1.1.2 Ownership of Repositories
All repositories under UoS Github Enterprise must be owned by a member of UoS, with the permission of the owner or their delegates of the Github Organisation in which it belongs to.

#### 1.1.3 Ownership of Github Organisations
All Github Organisations under UoS Github Enterprise must be owned by a staff or academic within the UoS. The owner of the Github Organisation may delegate their administrative responsibilities to other members of the Github Organisation who is also a member of UoS.

Github Organisations are co-owned by the UoS Enterprise Administration team for the purposes of support, administration and auditing only; the UoS Enterprise Administration team are exempt from the responsibilities stated in the “Responsibilities of Github Organisation Owners” section.

### 1.2 UoS Enterprise Github Organisations
There are no restrictions on the purpose of Github Organisations under UoS Enterprise; they can be created to represent various organisational levels within the University such as a specific course, project, research group, departmental/school, faculty or university wide.


### 1.3 Responsibility of Github Organisation Owners
It is the responsibility of the Github Organisation owners to manage their own members and repositories, and act in compliance with the following Github and the University’s Terms of Service and Code of conduct:

- Github Enterprise Terms of Service: https://docs.github.com/en/site-policy/github-terms/github-corporate-terms-of-service
- University of Sheffield Data Protection Policy: https://www.sheffield.ac.uk/media/17203/download?attachment

They are also responsible for the following:

#### 1.3.1 Management of Github Organisation Access
The owner of a Github Organisation must ensure that all members and collaborators meet the criteria under the “Eligibility” section.

#### 1.3.2 Management of Repositories
The owner of the Github Organisation must ensure that all repositories under their Github Organisation meet the criteria under the “Eligibility” section.

#### 1.3.3 Access and Ownership Review for Leavers
Should a member of a Github Organisation leave the research group or the University, their access permissions must be reviewed accordingly. Access to Github Organisation should be removed if the member no longer has need to access the contents of repositories within the organisation. The leaver’s private repositories within a Github Organisation should either be deleted, transferred to the owner or another eligible member of the organisation, or transferred to the UoS Github Enterprise Administration team for archival purposes.

Should the owner of a Github Organisation leave the University, the ownership of the organisation must be transferred to an eligible member of UoS or transferred under management of the UoS Enterprise Administration team if there are no eligible members and it is in the interests of the University to retain the organisation. Otherwise the organisation should be deleted along with its contents.

#### 1.3.4 Yearly Github Organisation Audit
A yearly audit is performed by the UoS Enterprise Administration team to ensure access and ownership is in compliance with the Eligibility criteria. Organisations which are no longer in use and does not contain repositories kept for archival purposes should be removed. The owner of the Github Organisation will work with the UoS Enterprise Administration to facilitate the process.
twinkarma marked this conversation as resolved.
Show resolved Hide resolved

#### 1.3.5 Fair Use
Due to limitations in availability of number of seats and github runner time, the owner of a Github Organisation must comply with access and usage warnings given by the UoS Enterprise Administration team. The UoS Enterprise Administration team reserves the right to restrict access and usage of GH Organisations in case of non-compliance.

### 1.4 Changes to the Service and Access Policy
Users should expect changes to the policy and service delivery during the early access program. The UoS Enterprise Administration team will ensure that organisation owners are contacted at least two weeks ahead of upcoming changes.

### 1.5 Feedback
UoS Github Enterprise Administration team will be using various means to collect feedback including feedback forms and directly contacting organisation owners. It is also possible provide feedback directly to [github-enterpise-admin-group@sheffield.ac.uk](mailto:github-enterpise-admin-group@sheffield.ac.uk).

## 2. Communications
Various channels of communication are available:

- The [github-enterprise-announce](https://groups.google.com/a/sheffield.ac.uk/g/github-enterprise-announce-group) google group is used to announce service updates. Organisation owners and administrators are automatically enrolled in the group.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I may need to be added to this group, I already have an org that you created for me a few months ago.

- Queries, feedback and support requests can be made by contacting The UoS Github Enterprise Administration Team at [github-enterpise-admin-group@sheffield.ac.uk](mailto:github-enterpise-admin-group@sheffield.ac.uk).

## 3. What Happens Once Your Access Request is Approved
A new Github Organisation will be created on UoS Github enterprise with you as its owner. It is then the responsibility of the organisation's owner and its administrators to manage their own teams and repositories within the organisation in compliance with the access policy above.

## 4. Migrating an Existing Organisation
Instead of creating a new organisation, existing organisations can be migrated into UoS Github Enterprise when applying using the request form link below. The migrated organisation should be made compliant to the access policy by the first audit that will happen roughly a year after the migration.

## 5. Requesting access

<a href="https://forms.gle/BS7uSbVpd7mCFAh69" class="btn btn-primary">Request the creation or migration of a Github organisation</a>
Loading