@@ -6,8 +6,8 @@ ETSI delivery repository is the git repository containing some software or sourc
The published ETSI delivery can contain a part of the repository content or a reference to the tagged or released version within the repository.
- The ETSI delivery repository is publicly available. It shall not contain any private, sensitive or confidential information.
- The ETSI delivery repository can contain multiple release branches. New release branch can be created when the new version of the publishing document shall be associated with the new release or pack of standards.
- The ETSI delivery repository shall not contain any development branches excepting the one or more WI rapporteur's branches ( WI branches) been used to collect merge requests from individual developers.
- The ETSI delivery repository may contain multiple release branches. New release branch can be created when the new version of the publishing document shall be associated with the new release or pack of standards.
- The ETSI delivery repository should not contain any development branches excepting the one or more WI rapporteur's branches ( WI branches) been used to collect merge requests from individual developers.
- The ETSI delivery repository is associated with the Technical Body responsible for the delivery.
- The ETSI delivery repository can be maintained by
- ETSI technical officers
@@ -18,8 +18,9 @@ The published ETSI delivery can contain a part of the repository content or a re
The ETSI delivery repository can be created when new WI of the new ETSI delivery is approved and the software code is intended to be the part of this delivery.
The ETSI delivery repository shall be named as \<tag\>_\<document number\> where:
- tag is the short acronym to identify the module. (optional)
The ETSI delivery repository should be named as \<tag\>_\<document number\> where:
- tag is the short acronym to identify the module or component described. (optional)
- document number is the ETSI delivery number.
> Examples: sec_ts103097, cdd_102984_2, etc.
@@ -54,18 +55,20 @@ It is up to Technical Body to select the strategy to be applied for ETSI deliver
- The new development repository (WI repository) can be forked from the ETSI delivery repository when new work item is approved.
- The name of the WI repository contains the name of the ETSI delivery repository and the WI reference number (for example `sec_ts103097_0000035`).
- The WI repository is visible for EOL accounts only.
- The WI repository is managed by the WI rapporteur.
- The WI repository can contain development branches created by the rapporteur or by other members of the project. Everybody can request for the project membership.
- Private repositories can also be used to prepare merge requests.
- The WI rapporteur collects merge requests from individual developers and merge it into the master of WI repository.
- The WI repository is maintained by the WI rapporteur.
- The WI repository may contain development branches created by the rapporteur or by other members of the project. Everybody with an EOL account and with access rights to the standardization group may request for the project membership.
- Private repositories may also be used to prepare merge requests.
- The WI rapporteur collects merge requests from individual developers and merge it into the master of WI repository according to the contribution procedure.
### Contribution procedure
- According to the contribution strategy, contributors can create a new branch in the WI repository or fork the ETSI delivery repository in their private namespace.
- According to the contribution strategy, contributors may create a new branch in the WI repository or fork the ETSI delivery repository in their private namespace.
See [Gitlab's branching documentation](https://docs.gitlab.com/ee/user/project/repository/branches/) for more details.
- Contributors make a set of changes (either modifications or additions) to the Forge platform using the newly-created branch.
- Contributors submit a Merge Request from the branch containing their changes to the WI branch or WI repository.
If some contrubution needs to be approved on the TB meeting, the contributor performs the following stages:
If a contribution needs to be approved on the TB meeting, the contributor performs the following stages:
- The contributor reserves a contribution number on the ETSI Portal and includes this number in the Merge Request description.
- The contributor prepares and makes available a contribution on the Portal. The contribution contains a link to the Merge Request and a description of proposed changes.
- The contribution can also contain changes to other elements of the deliverable (e.g. textual descriptions, tables, figures, etc.) required to maintain consistency with the changes proposed in the Merge Request.
@@ -76,11 +79,11 @@ If some contrubution needs to be approved on the TB meeting, the contributor per
- The rapporteur prepares the delivery document and the WI branch or the master branch of WI repository for publication.
- The rapporteur creates the tag with the new expected version of the delivery (`v1.2.1` for example)
in the WI branch or repository and provides the link to the tag to the editHELP team.
- Some changes can be made in the development branch during the editHelp processing.
- Some changes can be made in the development branch during the editHelp processing. Editorial changes may be applied at discretion of the Rapporteur or of the Technical Officer.
- The WI rapporteur shall merge the approved version of the software from the WI branch or repository into the correspondent branch of the ETSI delivery repository.
- The WI rapporteur shall create the tag with the new version of the delivery (`v1.2.1` for example).
- The delivery document can include one of the following:
- The delivery document may include one or both of the following:
- The copy of the repository content;
- The reference to the tag in the ETSI delivery repository;
- The reference to the release archive in the ETSI delivery repository;
- The WI rapporteur shall inform the editHelp team about the reference URL to bi included in the delivery document.
- The WI rapporteur shall inform the editHelp team about the reference URL to be included in the delivery document.