From owner-freebsd-doc@freebsd.org Sat Dec 1 19:04:49 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 C5DEC1324E78 for ; Sat, 1 Dec 2018 19:04:49 +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 5B4B7708EC for ; Sat, 1 Dec 2018 19:04:49 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: by mailman.ysv.freebsd.org (Postfix) id 1EE221324E77; Sat, 1 Dec 2018 19:04:49 +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 D87C31324E76 for ; Sat, 1 Dec 2018 19:04:48 +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.3 with cipher TLS_AES_256_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 76EE8708EA for ; Sat, 1 Dec 2018 19:04:48 +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 A33381E851 for ; Sat, 1 Dec 2018 19:04:47 +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 wB1J4l03017519 for ; Sat, 1 Dec 2018 19:04:47 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id wB1J4l0M017518 for doc@FreeBSD.org; Sat, 1 Dec 2018 19:04:47 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 233696] Porter's handbook: Makes clearer the official policy about port signatures Date: Sat, 01 Dec 2018 19:04:47 +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 Only Me X-Bugzilla-Who: phascolarctos@protonmail.ch 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 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-Rspamd-Queue-Id: 5B4B7708EC X-Spamd-Result: default: False [1.95 / 15.00]; local_wl_from(0.00)[freebsd.org]; NEURAL_SPAM_LONG(0.57)[0.567,0]; NEURAL_SPAM_MEDIUM(0.51)[0.511,0]; ASN(0.00)[asn:10310, ipnet:2001:1900:2254::/48, country:US]; NEURAL_SPAM_SHORT(0.88)[0.875,0] X-Rspamd-Server: mx1.freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 01 Dec 2018 19:04:50 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D233696 Bug ID: 233696 Summary: Porter's handbook: Makes clearer the official policy about port signatures Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Only Me Priority: --- Component: Documentation Assignee: doc@FreeBSD.org Reporter: phascolarctos@protonmail.ch This bug report is similar to bug #228715, but slightly different. If I understood it well, old ports are allowed to keep "Created by:..." lin= es but new ports are not allowed to include one. This is based on my experienc= e. It still happens that new ports creators try to insert "Created by: ..." li= nes (as a new FreeBSD contributor, I did it on my first new port less than 6 mo= nths ago): the handbook discourages it, but the ports tree includes many "bad" examples. Such examples create confusion and might make new contributors fe= el bad when seeing that they cannot sign their work while others did (I felt a= bit bad at first, before understanding the policy). Furthermore, if someone interprets this fact as "once signatures were allow= ed, now they are not any more", one could think that (s)he should remove existi= ng lines from existing ports (like I recently did in bug #233662), which seems= to be against the official policy (unless the creator has been asked). Specifying the correct policy once and for all in the porter's handbook is = the best way to avoid similar problem in the future: if what I think to be the official policy is wrong, feel free to correct it. (My personal opinion is that we should remove all signatures, both old and = new: ports change over time and creators ends up with a signature that stays on a Makefile that can be very different to what they wrote when they left maintainership. Credit for creation can still be recognized through other m= eans like Bugzilla or SVN. This policy also has the advantage to be fair between= old and new contributors.) --=20 You are receiving this mail because: You are the assignee for the bug.=