From owner-freebsd-current@freebsd.org Thu Oct 5 15:17:18 2017 Return-Path: Delivered-To: freebsd-current@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 7AD24E3B071; Thu, 5 Oct 2017 15:17:18 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2610:1c1:1:6074::16:84]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "freefall.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 5840F75897; Thu, 5 Oct 2017 15:17:18 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from FreeBSD.org (freefall.freebsd.org [IPv6:2610:1c1:1:6074::16:84]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by freefall.freebsd.org (Postfix) with ESMTPS id 45B0C10F11; Thu, 5 Oct 2017 15:17:17 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Date: Thu, 5 Oct 2017 15:17:15 +0000 From: Glen Barber To: freebsd-doc@FreeBSD.org Cc: freebsd-current@FreeBSD.org, FreeBSD Documentation Engineering Team , FreeBSD Release Engineering Team Subject: HEADS-UP: release-releated documentation moving from base to doc repository Message-ID: <20171005151715.GB49395@FreeBSD.org> Reply-To: gjb@FreeBSD.org MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="CUfgB8w4ZwR/yMy5" Content-Disposition: inline User-Agent: Mutt/1.8.2 (2017-04-18) X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 05 Oct 2017 15:17:18 -0000 --CUfgB8w4ZwR/yMy5 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hi, I have expressed my intent to move the release-related documents from the src tree to the doc tree in the past. This has been met with some resistance, but I think this change is far overdue at this point. The primary motivation behind this change is that if there is an error in release-related documentation that goes unnoticed until the release announcement is sent, we are effectively stuck with the erroneous information in the release notes (although we can document the error in the errata.html page), as once the release is tagged in Subversion, the sources that generate the relnotes.html, readme.html, etc., cannot be modified. Moving the sources from the base repository to the doc repository (which does not have an explicit "freeze") allows us to change incorrect entries, add missing entries, etc. post-release, as needed. I am currently re-testing and triple-checking the changes to pull the relevant files into the doc repository in preparation to commit the changes, which I expect to have in the tree within the next few hours if all goes well. At latest, it should be committed by tomorrow. At present, I am undecided if I will make this change retroactive to stable branches. I do not expect any doc build breakage, but assume I am looking into anything that breaks as a result. Please bear with me if things do explode. Thanks. Glen --CUfgB8w4ZwR/yMy5 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEVVuz/A7vpH93hEhKuWzd6q+LXtAFAlnWTPsACgkQuWzd6q+L XtArsw/+M6/BAZphwK79bF8yoyk3ePogG/pSuR4LUOSJWpF4H2ZFaqP+oz74Gw6Y dSLk/3nL22aCbxSAarestZGMP91xsEwhjW5jTSg5Vyqvm0hRRD87HiIDOK3/95jc TnhP52pNEpEtS11aXyDmmUtcfCtRZWZ4TzZJc320hA/pJYrlnZlBl7iOKSC3SEOO z+BNWSafhUN1N/pMSi06OOunmH4obhKwNRZoju8MVbra8F3VZVOYUWkEOD8OesXT JvfoUNsApB4BQJ5qwwBfzgTzGPswQM5z2Zo+KSddSKzkhIKqy4k57H8Ne4o6+xOr UMEQE8T+l0mkMrMSsG+gZlmJrWPhiIQtBQkqeuL2r/Z/s4zpT1jFbEllrbYTA8OA o8hWgDNfpEnioK0IE0TWuOWeCGoOEQbqwf95PDV/ToBNjG7RiMEpvIJRftNTM1Fw wHCzP9NK2JRFuMUBtZTC3oxnxQsgTXuWcRHEsHYL1MDUJsew3NKL5QrcykxGH+FQ tBuIBC7ECIWVNzwc4rpBSk0+dVqRwn787bPa7ZF1akUOxHQsp0S5Wb08tkbJnBKK EcpqGFK0FB2C/s/IxQNExpKX0RxeKodAMU9DYjWVEDHWiBv7McjrS7BCeleh+QJN BHSRBAny/jhvHTzlZ9pOhy7OCJ6V6hkqmY4JjWQ0loz3jor6zK8= =VUtf -----END PGP SIGNATURE----- --CUfgB8w4ZwR/yMy5--