From owner-freebsd-doc@freebsd.org Fri May 18 23:34:00 2018 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 27903EE0501 for ; Fri, 18 May 2018 23:34:00 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mailman.ysv.freebsd.org (mailman.ysv.freebsd.org [IPv6:2001:1900:2254:206a::50:5]) by mx1.freebsd.org (Postfix) with ESMTP id AFB826F9EF for ; Fri, 18 May 2018 23:33:59 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: by mailman.ysv.freebsd.org (Postfix) id 700F4EE0500; Fri, 18 May 2018 23:33:59 +0000 (UTC) Delivered-To: doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 32247EE04FD for ; Fri, 18 May 2018 23:33:59 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.ysv.freebsd.org (mxrelay.ysv.freebsd.org [IPv6:2001:1900:2254:206a::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.ysv.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id B448E6F9EE for ; Fri, 18 May 2018 23:33:58 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.ysv.freebsd.org (Postfix) with ESMTPS id E989E23AFF for ; Fri, 18 May 2018 23:33:57 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id w4INXvIB033606 for ; Fri, 18 May 2018 23:33:57 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id w4INXvIV033605 for doc@FreeBSD.org; Fri, 18 May 2018 23:33:57 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 228353] articles/committers-guide: Document "Sponsored by:" commit log line Date: Fri, 18 May 2018 23:33:57 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Documentation X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: john@saltant.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: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter attachments.created Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 18 May 2018 23:34:00 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D228353 Bug ID: 228353 Summary: articles/committers-guide: Document "Sponsored by:" commit log line Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Some People Priority: --- Component: Documentation Assignee: doc@FreeBSD.org Reporter: john@saltant.com Created attachment 193524 --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=3D193524&action= =3Dedit articles/committers-guide: Document "Sponsored by" Problem statement =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D 1. The "Sponsored By" line is not documented in the Committers' Guide, thr= ough it has been included in the FreeBSD-specific patch to the devel/subversion = port since March, 2013 [0]. 2. Common practice for using the "Sponsored By" line does not handle well = the case where a commit is the result of work by multiple individuals who typic= ally have different sponsorship including some who have no sponsorship at all. In this case, a sponsorship credit tends to have the unintended implication th= at the work of all collaborators was sponsored and by the same sponsor, which = is rarely the case. [0] https://svnweb.freebsd.org/changeset/ports/314983 Discussion =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D A preliminary discussion of the problem statement and the concept for this patch took place on the freebsd-ports@ list [1]. [1] https://lists.freebsd.org/pipermail/freebsd-ports/2018-May/113352.html Proposed solution =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D The attached patch contributes documentation (in English) to address both p= arts of the problem statement. Translations =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D The Committers' Guide is offered in English, French, Italian, and Russian, = so a full solution should include patches for the other three languages. --=20 You are receiving this mail because: You are the assignee for the bug.=