From owner-freebsd-stable@FreeBSD.ORG Thu Jun 27 23:24:22 2013 Return-Path: Delivered-To: stable@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 47F82DAC; Thu, 27 Jun 2013 23:24:22 +0000 (UTC) (envelope-from 000.fbsd@quip.cz) Received: from elsa.codelab.cz (elsa.codelab.cz [94.124.105.4]) by mx1.freebsd.org (Postfix) with ESMTP id 073C81633; Thu, 27 Jun 2013 23:24:21 +0000 (UTC) Received: from elsa.codelab.cz (localhost [127.0.0.1]) by elsa.codelab.cz (Postfix) with ESMTP id 2BCCD2842E; Fri, 28 Jun 2013 01:24:19 +0200 (CEST) Received: from [192.168.1.2] (ip-89-177-49-222.net.upcbroadband.cz [89.177.49.222]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by elsa.codelab.cz (Postfix) with ESMTPSA id F2CE22842B; Fri, 28 Jun 2013 01:24:17 +0200 (CEST) Message-ID: <51CCC9A1.30401@quip.cz> Date: Fri, 28 Jun 2013 01:24:17 +0200 From: Miroslav Lachman <000.fbsd@quip.cz> User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.9.1.19) Gecko/20110420 Lightning/1.0b1 SeaMonkey/2.0.14 MIME-Version: 1.0 To: Mark Felder Subject: Re: request for your comments on release documentation References: <20130613.024921.2080910235950489908.hrs@allbsd.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: stable@freebsd.org, current@freebsd.org X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 27 Jun 2013 23:24:22 -0000 Mark Felder wrote: > On Wed, 12 Jun 2013 12:49:21 -0500, Hiroki Sato wrote: [...] >> 3. Is there missing information which should be in the relnotes? >> Probably there are some missing items for each release, but this >> question is one at some abstraction level. Link to commit log and >> diff, detailed description of major incompatible changes, and so >> on. > > I try to keep up with the development and changes in releases as best I > can and I haven't noticed any glaring omissions over the last several > releases. I think you're doing a fine job. > > Also, is there a reason this isn't a "living" document that can be > updated as things get MFC'd to STABLE? It would help take load off your > end and maybe speed up release once the freeze has happened and we begin > the final grind through release candidates. It would be nice if all release related documents (relnotes, errata, hardware notes etc.) will be "living" after release (in online version) and not considered as set in stone. There are sometimes missing items which should be included online as soon as possible, but rarely are. For example, I found two issues with OpenSSH in 8.4 release. (bugs or features, or just incompatibilities with older versions) None of them is listed anywhere and I think it is really bad, because one issue can cause sshd not started after upgrade. So the online version of these docs should be "living" and updated as some issues and questions arises on the mailing lists and forums few days / weeks after release. On the other hand, FreeBSD has good quality of docs included Release Notes. (thank you for your work!) If there is some "man power", some items can be more detailed with links to other online resources like FreeBSD wiki, but only for some important items. Miroslav Lachman