From nobody Thu Jun 09 01:52:32 2022 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id D6D0683798D for ; Thu, 9 Jun 2022 01:52:32 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4LJRtS32rNz3Bm4 for ; Thu, 9 Jun 2022 01:52:32 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 466751B389 for ; Thu, 9 Jun 2022 01:52:32 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 2591qWNL063026 for ; Thu, 9 Jun 2022 01:52:32 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 2591qWUL063025 for doc@FreeBSD.org; Thu, 9 Jun 2022 01:52:32 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 264562] New Account Creation Procedure: corrections Date: Thu, 09 Jun 2022 01:52:32 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Website X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: grahamperrin@gmail.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1654739552; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=Ay/jwhAdn9lnWY7ChvwHvM3el/JS6DxDWNMOzpvpyu0=; b=LQshikYD8EHCOyJcPA+o3UO+wFXiWpLU09TKChmkT/hjyuloUiV0J9CGI/Yf+lNN9mvRDS vUf39q2ovTK6ZdC5CDE/ipKDImvsClIm67NoiJ4LmzkelyquT/kG+i16aMMrEu1CD4/j4v 7yTtk5w/5SIsM2fZULKkdlJfneK9kbh8HF07pUOIV5RLi/tMK7TprfS8dqBSfD3CGGFSI+ 5DpGbR2ko5A5YvafVzRUUf6ldx8+J5Oke0RZ1eCnyC0mmqgkqMkHGpwla0g9/RNCLkJpm7 JFUAS+axSahQaq535SpCPP0eTsORI3G2BvNC+0RLcvp5vzuQKopUZRGiKmD+8Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1654739552; a=rsa-sha256; cv=none; b=TAMnBjzUMntkIvYjfqYGxgkdyYikJJKUAS+QZK+0NG4h6+PU4Qm8wTG0mFYzMamMam0Qp9 sVMRca/PX4I3v8/sDww5Gcb1BcFDn1zqPYyZ9KQO70FToWNZf0Dt9hH6B75WhA2llTB08I z2SxkBsKg7cWJw8FAkiGvhOSAAvYKyZBGhTwhPqyhoVtO9WAMHbEzYnmhULWHkRg7v+sZk a1jLYnJNEqk2k5YOgCYgZon5r2eRssLe9dgROSx31ay+pTO25ia5m5+OLRbUvl91b3utfA 4Au4c74Ia86OkwzkMcBIp9KOVdJgKUMGTgd/W447RMaYzoCUReswXvqIT9jO1w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D264562 --- Comment #2 from Graham Perrin --- for n= ew committers there's a ten-step Procedure 1 =E2=80=93 however as far as I can tell, there's no second procedure (2) any= where in the article.=20 For me, as a new committer with a bit for doc, step 5 of 10 should be:=20 src/share/misc/committers-doc.dot =E2=80=93 with mentor approval before the commit.=20 ---- Pause for thought. Re: comment 0, here's the single-paragraph section of the page in its entirety:=20 > After the new committer confirms that the account works, the mentor=20 > adds the new committer to the correct access file, using an appropriate=20 > commit message. The commit message should at least contain the committer= =E2=80=99s=20 > full name and username, the mentor=E2=80=99s name and what area the new c= ommitter=20 > will start to work in. An entry should also be added to the mentors file= =20 > in the respective Git repository to indicate the mentor relationship.=20 > Having done all that, the new committer and mentor jointly go through the= =20 > first commit operations. The final sentence is for joint actions, _first_ commit operations.=20 For the preceding sentence, it's implicit that addition "to indicate the me= ntor relationship" is performed by a mentor alone =E2=80=93 _not_ a joint action= .=20 ---- However, _joint_ step 5 of 10 is an addition to indicate the mentor relationship. Two examples:=20 If it's true that the new account creation procedure contradicts the Committer's Guide, then I'm inclined to:=20 1. treat the setup section of Committer's Guide as definitive 2. make =20 consistent, and a little clearer. --=20 You are receiving this mail because: You are the assignee for the bug.=