From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6465300707308208128 X-Received: by 10.28.191.71 with SMTP id p68mr104640wmf.8.1505376675877; Thu, 14 Sep 2017 01:11:15 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 10.46.84.87 with SMTP id y23ls360646ljd.11.gmail; Thu, 14 Sep 2017 01:11:15 -0700 (PDT) X-Google-Smtp-Source: AOwi7QBhdS5amBzkdlbvJzGfRvRmWi2LaQgJQXS0sAaPjHIqGUzom3RTMqsIaB1GalUM7rIB821W X-Received: by 10.46.65.84 with SMTP id o81mr1095247lja.19.1505376675118; Thu, 14 Sep 2017 01:11:15 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1505376675; cv=none; d=google.com; s=arc-20160816; b=nW7rzjnW/LwnsYt/L9FA16Pm2slJTpo+xcXjUB93LNyywsX8P9VrHDFMNmgrlJmirl 6E7K+NHvzVD6iZBuX+uR7z5xY+7tc51vCfVtTw4nCq3CFNIZ9uUEAYykqZUfit1F0XlG aq2nG0XXkpT3ieLl1m4vxZc+SmMTgXCosai/1CJTVQJ8rvZlL0rcPDbI5AtIBG/0UuRw zZt3O41mJq8t9TibtMKHtGgcG41Jax4NziE3thvusVa7l9LJYh9/e9s9Qe54+VuK8pPR 5+cPoirRmpb+TAEebwUztzqshmj6otd2qJmIrHhJ7KdWICjx9AjC4jthjM6uByKkGx+l u06A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:content-language:in-reply-to:mime-version :user-agent:date:message-id:from:references:to:subject :arc-authentication-results; bh=o/4E/SF/zBJYj/rTR1qRgJP+UBTz0+c5wXjFQ5w7H0U=; b=DcxPoYz8OwhJIjTvWuJEEB6qhGtMRHcrZsUczdGb7yxbOB4hs3uMAb4b3cFGDYDvfH JZ8BYbC5O2CmstiLrxkWyweUCWeOmd/18tY46962qJsYTPl+yWqF19oeas4C3s+cmMat KNMfrVd9PlAkG4ZKLio/Psyd/YQFeKjESMFW6tvjZQufGE8s4b+nG3xnbSMRBoQI9Clf PgcWLSP7CLrOeUENfAaXJiMoEZjRhT5+PZxHGIb2V9A3s8DfSJljByOzmmy1EXgGaOql jEGgTMPbt2rs8SzXWTL+5eFWoa9HDtRBAxIT7BKkLygoECOTKAI0hiApxP/S2DSzw6G7 K8OQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=neutral (google.com: 192.35.17.14 is neither permitted nor denied by best guess record for domain of jan.kiszka@siemens.com) smtp.mailfrom=jan.kiszka@siemens.com Return-Path: Received: from david.siemens.de (david.siemens.de. [192.35.17.14]) by gmr-mx.google.com with ESMTPS id s127si44691wme.8.2017.09.14.01.11.15 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 14 Sep 2017 01:11:15 -0700 (PDT) Received-SPF: neutral (google.com: 192.35.17.14 is neither permitted nor denied by best guess record for domain of jan.kiszka@siemens.com) client-ip=192.35.17.14; Authentication-Results: gmr-mx.google.com; spf=neutral (google.com: 192.35.17.14 is neither permitted nor denied by best guess record for domain of jan.kiszka@siemens.com) smtp.mailfrom=jan.kiszka@siemens.com Received: from mail2.siemens.de (mail2.siemens.de [139.25.208.11]) by david.siemens.de (8.15.2/8.15.2) with ESMTPS id v8E8BEFR006845 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 14 Sep 2017 10:11:14 +0200 Received: from md1f2u6c.ww002.siemens.net ([139.22.34.242]) by mail2.siemens.de (8.15.2/8.15.2) with ESMTP id v8E8BDM8015909; Thu, 14 Sep 2017 10:11:14 +0200 Subject: Re: [PATCH v2] doc: Add maintainer process To: Alexander Smirnov , isar-users@googlegroups.com References: <20170913162819.10439-1-asmirnov@ilbers.de> From: Jan Kiszka Message-ID: Date: Thu, 14 Sep 2017 10:11:13 +0200 User-Agent: Mozilla/5.0 (X11; U; Linux i686 (x86_64); de; rv:1.8.1.12) Gecko/20080226 SUSE/2.0.0.12-1.1 Thunderbird/2.0.0.12 Mnenhy/0.7.5.666 MIME-Version: 1.0 In-Reply-To: <20170913162819.10439-1-asmirnov@ilbers.de> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit X-TUID: QR7EsHvTpYlF On 2017-09-13 18:28, Alexander Smirnov wrote: > This patch adds basic maintainer process description, that has been > used so far since the project start. > > Signed-off-by: Alexander Smirnov > --- > doc/maintainer.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 52 insertions(+) > create mode 100644 doc/maintainer.md > > diff --git a/doc/maintainer.md b/doc/maintainer.md > new file mode 100644 > index 0000000..2b9a8c7 > --- /dev/null > +++ b/doc/maintainer.md > @@ -0,0 +1,52 @@ > +# Introduction > + > +Isar maintainer is the person who keeps the project development in > +compliance with the contributing process definition. The purpose of > +this document is to describe the maintainer process in the Isar > +project. > + > +# Responsibilities > + > +## Feedback on Contributions > + > +The Isar maintainer should review each contribution that has been sent > +to the mailing list and provide feedback. The feedback could be on of "can be" - or "shall be"? Recommendation or clear definition? Also: s/on/one/ > +the following categories: > + > + - Contribution accepted: If no quality and design issues were found > + by the maintainer and the other mailing list members. > + > + - Change request: If some small quality or design issues were found, > + the maintainer or the other mailing list memeber requests a new > + version with resolved issues. > + > + - Contribution rejected: If there are major design issues or general > + benefit from the contribution is ambiguous. > + > +During the review, the maintainer may ask additional questions to > +clarify the details. Any other mailing list member could assist the > +maintainer in the review process. > + > +## Repository Branches > + > +There are two official branches in Isar, intended to increase project > +quality: > + > + - next: The accepted contributions from the mailing list are merged > + to this branch. Basic CI checks should be run after each merge. > + This branch could be forced. I think you mean "can be rebased" or "change non-linearly". > + > + - master: Is the official stable branch. The only way patches go in > + here is coming from 'next', where they have passed all required > + tests and undergone the review process. On this branch force-pushing > + will never be used. > + > +The next branch is intended to be merged into master monthly. The > +maintainer could perform a merge to master before the ordinary window "may perform" > +if the next branch contains urgent patch series (bug fixes or critical > +features). > + > +## Issues at GitHub > + > +For each issue that has been found in master and next branches the > +maintainer should create a GitHub issue. > That does not define what an "issue" is (e.g. granularity). Jan -- Siemens AG, Corporate Technology, CT RDA ITP SES-DE Corporate Competence Center Embedded Linux