Skip to content
Snippets Groups Projects
Commit d725c5d3 authored by Wayne Beaton's avatar Wayne Beaton
Browse files

Update GitLab information.

parent f090d019
No related branches found
No related tags found
No related merge requests found
......@@ -25,7 +25,7 @@
<groupId>org.eclipse.dash</groupId>
<artifactId>org.eclipse.dash.handbook</artifactId>
<version>2021.12.08</version>
<version>2022.03.18</version>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
......
......@@ -16,7 +16,7 @@
[[notices]]
== Notices
Copyright (C) 2015, 2020 Eclipse Foundation, Inc. and others.
Copyright (C) 2015, 2022 Eclipse Foundation, Inc. and others.
Made available under the {epl20Url}[Eclipse Public License v 2.0].
......
......@@ -140,10 +140,18 @@ endif::[]
[[pmi-contributors]]
==== Contributors
In order to grant the ability to assign issues and merge/pull requests to non-committers on repositories that are hosted on GitLab or GitHub, developers must be designated as _contributors_.
The project team can choose to designate specific individuals as official contributors. On xref:resources-gitlab[GitLab], designated contributors are granted the _Reporter_ role in the project's repositories. On xref:resources-github[GitHub], designated contributors are granted the _triage_ permission. Contributors can create merge and pull requests regardless of whether or not they are designated as an official contributor.
Contributors can be designed by adding their email address to the _Contributors_ field. The contributor must have an Eclipse Foundation account using the email. In the case of GitHub, the contributor must also provide their GitHub ID in their <<contributing-account,Eclipse Foundation Account>>.
Any committer or project lead can add or remove contributors for their own project. To set the add or remove contributors:
* Log into the PMI;
* Navigate to the <<pmi-project-page,project page>>;
* click <<pmi-editing,_Edit_>>;
* Open the section labeled _Source Code and Issues/Bugzilla_; and
* Add/remove email addresses to/from the _Contributors_ field.
[[source-repositories]]
==== Source Repositories
......
......@@ -105,13 +105,43 @@ Authors who are not committers on the project receiving the commit must have an
The Eclipse Foundation maintains an instance of GitLab for use by {forgeName} open source projects. Project teams may opt to host some or all of their canonical source code repositories on our GitLab instance.
Any committer can https://gitlab.eclipse.org/eclipsefdn/gitlab[create an issue] to request that the Eclipse Webmaster create a new repository on, or move an existing repository to, the GitLab instance for their project. Note that the Webmaster will verify the request with the project leads.
[TIP]
====
Any committer can {helpdeskUrl}[create an issue] to request that the Eclipse Webmaster create a new repository on, or move an existing repository to, the GitLab instance for their project. Note that the Webmaster will verify the request with the project leads.
====
GitLab organizes content into a series of nested groups with `{forgeMachineName}` at the root, and the project's xref:trademarks-project-short[short name].
For example, the {forgeName} Dash project has a group of `{forgeMachineName}/dash` might have repositories with the following URLs (note that these URLs are provided as examples and may not actually be real):
* pass:a[{gitlabUrl}/{forgeMachineName}/dash/handbook]
* pass:a[{gitlabUrl}/{forgeMachineName}/dash/license-tool]
[NOTE]
====
Support for arbitrary nesting of groups on GitLab is being explored via https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/issues/42[Help Desk Issue #42].
====
Three teams are created for the group, each containing members from the corresponding {forgeName} open source project.
[TIP]
====
For information regarding the privileges available to each of the Maintainer, Developer, and Reporter roles indicated below, consult the https://gitlab.eclipse.org/help/user/permissions.md#project-members-permissions[GitLab Documentation].
====
Project Leads ::
All project leads are automatically added to this team. All members of the _project leads team_ are granted the _Maintainer_ role on their project's GitLab repositories. When an individual is xref:elections-pl[elected] into the role of project lead, they are automatically added to the _project leads team_. Likewise, when a project lead is xref:elections-retire-pl[retired], they are automatically removed from the team.
Committers ::
All committers are automatically added to this team. All members of the _committers team_ are granted the _Developer_ role on their project resources hosted on GitLab. When an individual is xref:elections-committer[elected] into the role of committer, they are automatically added to the _committers team_. Likewise, when a project lead is xref:elections-retire-cm[retired], they are automatically removed from the team.
All project committers are be granted _Developer_ level access to project resources hosted on GitLab.
Contributors ::
all project leads are granted _Maintainer_ level access to their project's GitLab repositories.
All contributors are automatically added to this team. All members of the _contributors team_ are granted _Reporter_ level access to project resources hosted on GitLab. When an individual is added to the project's xref:pmi-contributors[Contributors] list, they are automatically added to the _contributors team. Likewise, when they are removed from the contributors list, they are automatically removed from the team.
The <<contributing-eca,Eclipse Contributor Agreement>> (ECA) hook inspects incoming merge requests to ensure that the contributor has a valid ECA on file, and flags those that do no. Project committers should only accept merge requests that pass this validation.
The <<contributing-eca,Eclipse Contributor Agreement>> (ECA) hook inspects incoming merge requests to ensure that the contributor has a valid ECA on file, and flags those that do not. Project committers should only accept merge requests that pass this validation.
[[resources-github]]
=== GitHub
......
......@@ -72,6 +72,7 @@
:downloadsUrl: https://wiki.eclipse.org/IT_Infrastructure_Doc#Downloads
:versionNumberingUrl: https://wiki.eclipse.org/Version_Numbering
:helpdeskUrl: https://gitlab.eclipse.org/eclipsefdn/helpdesk
:bugzillaGitHubUrl: https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Community&component=GitHub
:epl20Url: http://www.eclipse.org/legal/epl-2.0
......
......@@ -26,6 +26,7 @@ include::config.adoc[]
:projectListUrl: http://projects.eclipse.org/list-of-projects
:bugzillaUrl: https://bugs.eclipse.org/bugs
:gitUrl: https://git.eclipse.org/c
:gitlabUrl: https://gitlab.eclipse.org
:gerritUrl: https://git.eclipse.org/r
:gitHubUrl: https://github.com/eclipse
:forumsUrl: http://www.eclipse.org/forums
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment