From owner-freebsd-doc@freebsd.org Tue May 23 00:18:15 2017 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id DCF38D78E15 for ; Tue, 23 May 2017 00:18:15 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: from mail-it0-x22a.google.com (mail-it0-x22a.google.com [IPv6:2607:f8b0:4001:c0b::22a]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 9B3B617B6 for ; Tue, 23 May 2017 00:18:15 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: by mail-it0-x22a.google.com with SMTP id g126so9651164ith.0 for ; Mon, 22 May 2017 17:18:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-transfer-encoding; bh=xaNKQbXtJx2pahXCRlk+5nRSfZqUQm9J06N4ECOXzEk=; b=Dn84d/D6NqDemwgnTkMjyeTKugW+yhJze1MVM7jPprzwzraJ5Lxm5kpTsCzrqxGDUO LpVlDkVKDreajSwL5O7OJHwC45jOVJI+Jajh6clGdSbVeLFmwR2BIoX6cRNDJ6cnYKqz ZZm4QUP4kiyCoIb3s84aY7j7zKtJB3RIrYghcCPJfAe5nFhQXmDWNLzh6z5aMKOdQcNW +xZo8T+4Q7O6eeRDQ6TGr4HoifqCO6BM9/N08gzQHvp7E1ol48qGJZtCJ/DarOZlqLcM EtipL2ONvm6mK4TGaMpXkWPo93o9K5+XnSE8mtobCg2otaCytsmlfu+VXAY3wY3BPxbu tKeg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:message-id:date:from:user-agent:mime-version:to :subject:references:in-reply-to:content-transfer-encoding; bh=xaNKQbXtJx2pahXCRlk+5nRSfZqUQm9J06N4ECOXzEk=; b=p6m7mYW2NkgcPHW758eKFSaeZhxmFriul9QBCZuLgTLSpPGX7Bo/pTQDgGtmJNy9I9 am22li19NkdzXRACN0fmssSqSocMhb8AMs20ECNU3+90fJ+yBY2ARvXueE5A0YwXbSb2 L65UArSm2twVVAzVbQS9ouBGsdlwbrpBK01HPZ1oXgmlAvAp9Chko8mU8ORDubnpOaPC biT2E1TKSWmd38qx7YE+rNSDLvdRh+YbXgYv4pIrxS3fp2+BvOg4Hwn7MMYOLQPgujJM hD7mDYlcDO4bQ8dynlCvepNr4SO5eHTIU4VTumS7Sv3f74siGkAj2ddInxmW2olTkPMc akqA== X-Gm-Message-State: AODbwcB+CXAUV3niOWE6PcnmHJAPFCR19GLpskoXvOsVbxUzO0nvwCOY UXTH8Ijr6xqb31nq X-Received: by 10.36.36.84 with SMTP id f81mr361891ita.24.1495498694878; Mon, 22 May 2017 17:18:14 -0700 (PDT) Received: from [10.0.10.3] (cpe-74-141-88-57.neo.res.rr.com. [74.141.88.57]) by smtp.googlemail.com with ESMTPSA id b197sm134579iti.16.2017.05.22.17.18.14 for (version=TLS1 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 22 May 2017 17:18:14 -0700 (PDT) Message-ID: <59237FD9.6000103@gmail.com> Date: Mon, 22 May 2017 20:18:33 -0400 From: Ernie Luzar User-Agent: Thunderbird 2.0.0.24 (Windows/20100228) MIME-Version: 1.0 To: freebsd-doc Subject: Re: [Bug 219421] [patch] handbook jail chapter removing ezjail section References: In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 23 May 2017 00:18:16 -0000 Trev wrote: > bugzilla-noreply@freebsd.org wrote on 21/05/2017 03:57: >> Bug ID: 219421 >> Summary: [patch] handbook jail chapter removing ezjail >> > Product: Documentation >> Version: Latest >> Hardware: Any >> OS: Any >> Status: New >> Keywords: patch >> Severity: Affects Many People >> Priority: --- >> Component: Documentation >> Assignee: freebsd-doc@FreeBSD.org >> Reporter: qjail1@a1poweruser.com >> Keywords: patch >> >> Created attachment 182757 >> --> >> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=182757&action=edit >> handbook jail chapter diff file >> >> In the comments for PR # 218849 people voiced concerns that it is >> inappropriate for the handbook to devote a section on how to use a >> port. That information belongs in the ports own documentation. > > I had assumed that this was correct... the Handbook only dealt with > "base" and a ports section had inadvertently been included. Until today, > when I was looking at the mail section of the Handbook and came across > these sections devoted to "ports": > > https://www.freebsd.org/doc/handbook/SMTP-Auth.html > https://www.freebsd.org/doc/handbook/mail-agents.html > https://www.freebsd.org/doc/handbook/mail-fetchmail.html > https://www.freebsd.org/doc/handbook/mail-procmail.html > > So, are all these sections to be removed also? Somehow I don't think so. > After review, I see these handbook links are totally different than the detailed step by step how-to ezjail section of the handbook. They are night and day different. It's not a question of providing names of ports that service a certain function. It's providing a whole section devoted to such in depth step by step instructions about a port. This gives the reader a implied endorsement of said port and the idea its the only solution. This is un-fair treatment of the other ports available as solutions for that same function. And more to the point this is the type of information that the port documentation it self should contain. When has it become the doc teams job to maintain a ports documentation? This is just so wrong on so many levels. I don't remember there being any open discussion about adding this type of section detailing ezjail usage before it was added to the handbook. It just showed up one day. I was not aware this is how major concept changes are made to the handbook. If the formal review process was done then please point me to it so I can understand the thinking back then that supported this.