Skip to content
Merged
Show file tree
Hide file tree
Changes from all 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
46 changes: 44 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,44 @@
# .github
Organisation level information
# ACCESS-Community-Hub Organisation

This repository contains organisation level information.


## Repository administration and membership

Repositories hosted in this organisation are maintained by the Community for the Community. To make this possible and ensure that everyone can contribute effectively, clear roles and responsibilities are necessary, along with some basic rules about how repositories are managed.

### Roles and Responsibilities:

- Repository Administrators:
- Manage access permissions for their repository, including granting write or maintainer privileges.
- Ensure repository policies and best practices are followed.
- Act as the final authority for changes in their repository.
- Advertise how users can request write access to the repository.
- Organisation Administrators:
- Create new repositories.
- Assign initial repository admins.
- Add members to the organisation.
- Provide support and guidance on organisational policies.

### Repository and organisation membership

Repositories in this organisation are administered by different people, and most users will usually only need write access to one or two repositories. As such, we recommend that access be granted per repository, instead of being granted at the organisation level. A common exception to this would be members that need to be part of a GitHub team, as only organisation members can join teams. If you would like to include a person as a member of this organisation, please get in touch with the organisation admins or create an issue in the [.github](https://github.com/ACCESS-Community-Hub/.github) repository.

Furthermore, we have the following policies about organisation-wide permissions:
- No special access is granted at the organisation level to members. This means that organisation members:
- cannot write to repositories unless they have been granted explicit write access at the repository level or are part of a team that has such permissions
- cannot read private repositories unless they have been granted explicit read access at the repository level or are part of a team that has such permissions.
- With the exception of the admin team, no team shall be granted organisation-wide privileges.

### Repository administration and creation

1. Repository Administration
- Each repository must have at least two administrators.
- Repository admins are responsible for managing user permissions for their repositories
- Teams can be created and used to manage access to repositories, but any such team should be clearly associated with a well defined repository or collection of repositories. Anyone creating a team must set themselves as a maintainer for that team.

2. Repository Creation
- Only organisation admins can create new repositories.
- To request the creation of a new repository, please create a [new issue](https://github.com/ACCESS-Community-Hub/.github/issues/new) in the [.github](https://github.com/ACCESS-Community-Hub/.github) repository of this organisation.
- Once a repository is created, organisation admins will assign initial repository admins.
- All repositories should be public to promote open collaboration, but exceptions can be made, in particular for licensing reasons.
11 changes: 9 additions & 2 deletions profile/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,5 +8,12 @@ None of the repositories contained in this Organisation are directly supported b
for the Community. Material supported directly by the ACCESS-NRI is hosted on the
[ACCESS-NRI GitHub organisation](https://github.com/ACCESS-NRI).

ACCESS-NRI retains formal administrative control of this organisation and will grant access to Community
members who wish to contribute.
ACCESS-NRI retains formal administrative control of this organisation. Access is
given to ACCESS-NRI staff and community members who wish to contribute. The
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Please see comment here:
#1 (comment)

regarding a consistent approach.

procedure to request access should be described in the README of each
repository.

Community members who wish to host a repository in this organisation should read
our [repository administration policy](https://github.com/ACCESS-Community-Hub/.github/README.md) and create a new
[issue](https://github.com/ACCESS-Community-Hub/.github/issues/new/choose)
requesting the creation of a new repository.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Please see comment here:
#1 (comment)

regarding a template licence. Or maybe it depends on the content of the repo'?