Date: Thu, 5 Oct 2017 15:17:15 +0000 From: Glen Barber <gjb@FreeBSD.org> To: freebsd-doc@FreeBSD.org Cc: freebsd-current@FreeBSD.org, FreeBSD Documentation Engineering Team <doceng@FreeBSD.org>, FreeBSD Release Engineering Team <re@FreeBSD.org> Subject: HEADS-UP: release-releated documentation moving from base to doc repository Message-ID: <20171005151715.GB49395@FreeBSD.org>
next in thread | raw e-mail | index | archive | help
--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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20171005151715.GB49395>