From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6465300707308208128 X-Received: by 10.25.38.140 with SMTP id m134mr830098lfm.2.1505739125835; Mon, 18 Sep 2017 05:52:05 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 10.46.64.203 with SMTP id r72ls819788lje.41.gmail; Mon, 18 Sep 2017 05:52:05 -0700 (PDT) X-Google-Smtp-Source: AOwi7QD1KXJGnZbOC2C2THF+FbNqcsblMiesQIC1+T/cgyP7bNCKUmW9KN0mAMUsHCDvIN+J3yli X-Received: by 10.25.193.142 with SMTP id r136mr884406lff.25.1505739125291; Mon, 18 Sep 2017 05:52:05 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1505739125; cv=none; d=google.com; s=arc-20160816; b=U6RHrJSKPxtgq4ZvsE8Atf6j8ONXcqxZvM1jQiU7fhE8Z1u1E1AUIX+b1akRjfZm0a lFYcCMkIYdINg4ettdHmLdP2x15ARhX4e13dnEh10x+m2QPN3RqQgqAUUzbMJDVXBujH QhOKpM3t6pLg4Q9m1WlMYgdI05+Sa60AmeEABAw2Gpe8L32kmaCLljsEhfxhtYguEMWS rTLrJcAwusG1pObgPNhsXBOBBBlbNJAEBsJZzBEAGRnvSvMeFtAG2i59kndmds/TFAnX B33zC69dkQq4ZuUVL44U/zkkngKvnakNYLc5TDgNaiev6SUSzNrVMTnzbSiO/0DyEG0b CBZw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:date:subject:cc:to:from:arc-authentication-results; bh=7GK/IszAWfTG+2xWRWQWBV80C0ouldqUCjc7ratHaYw=; b=ryd82jhv8Zjo0KIC3kbo0Wy67TnCvIpIaVi0caUFUu/rJNz8qgBm9kQJD/IhwHIC/e SSkYB+R9JE9nE1MVoTU3mP7fweU7j5DEgBglf5YYi3uLfm/DjQ/3cXtcQH9ttiTf7Exn XqIGouk6u9o4212TvebEwuRJm34JtVgXTN4IBHyFYpfPi3nLlHLjBGcxvEjvAChFrjyO flyQ+OLS0h0++MsHq7nYJa0wjl2GuVxdrVDrFI863gFMqmQ+K9qA8wSgIfsjjrADfqyE DIha+vkHGmp12DM6c3bql3cpgeGqqDxNTCeUqSQJHx5GFnZZBDszfyz4P8H1+IR6PptK c9jg== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: best guess record for domain of asmirnov@ilbers.de designates 85.214.62.211 as permitted sender) smtp.mailfrom=asmirnov@ilbers.de Return-Path: Received: from aqmola.ilbers.de (aqmola.ilbers.de. [85.214.62.211]) by gmr-mx.google.com with ESMTPS id 200si56336wmj.0.2017.09.18.05.52.05 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 18 Sep 2017 05:52:05 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of asmirnov@ilbers.de designates 85.214.62.211 as permitted sender) client-ip=85.214.62.211; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: best guess record for domain of asmirnov@ilbers.de designates 85.214.62.211 as permitted sender) smtp.mailfrom=asmirnov@ilbers.de Received: from localhost.localdomain ([188.227.110.165]) (authenticated bits=0) by aqmola.ilbers.de (8.14.4/8.14.4/Debian-4+deb7u1) with ESMTP id v8ICppm7006096 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 18 Sep 2017 14:51:57 +0200 From: Alexander Smirnov To: isar-users@googlegroups.com Cc: Alexander Smirnov Subject: [PATCH v3] doc: Add maintainer process Date: Mon, 18 Sep 2017 15:51:41 +0300 Message-Id: <20170918125141.26202-1-asmirnov@ilbers.de> X-Mailer: git-send-email 2.9.4 X-TUID: 0jMl+ekDPoYX 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 | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 doc/maintainer.md diff --git a/doc/maintainer.md b/doc/maintainer.md new file mode 100644 index 0000000..c9775e0 --- /dev/null +++ b/doc/maintainer.md @@ -0,0 +1,56 @@ +# 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 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 changed 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 may perform a merge to master before the ordinary window +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. The issue should reflect to +the one of the following: + - Bug in the existing Isar code. + - New Isar feature that is planned to be developed. + - Improvement that would be nice to have in Isar. -- 2.1.4