From gjb at FreeBSD.org Sun Dec 8 07:37:51 2013 From: gjb at FreeBSD.org (Glen Barber) Date: Sun, 8 Dec 2013 07:37:51 +0000 (UTC) Subject: svn commit: r43294 - user/gjb Message-ID: <201312080737.rB87bpTr052447@svn.freebsd.org> Author: gjb Date: Sun Dec 8 07:37:51 2013 New Revision: 43294 URL: http://svnweb.freebsd.org/changeset/doc/43294 Log: Add user/gjb/ directory for some work-in-progress stuff. Approved by: doceng (implicit) Sponsored by: The FreeBSD Foundation Added: user/gjb/ From gjb at FreeBSD.org Sun Dec 8 07:43:45 2013 From: gjb at FreeBSD.org (Glen Barber) Date: Sun, 8 Dec 2013 07:43:44 +0000 (UTC) Subject: svn commit: r43295 - user/gjb/releng-rewrite Message-ID: <201312080743.rB87hiL1055445@svn.freebsd.org> Author: gjb Date: Sun Dec 8 07:43:44 2013 New Revision: 43295 URL: http://svnweb.freebsd.org/changeset/doc/43295 Log: Copy head at r43294 -> user/gjb/releng-rewrite. Intent of this branch is to update the FreeBSD Release Engineering Team documentation to something more recent than FreeBSD 4.4. Approved by: doceng (implicit) Sponsored by: The FreeBSD Foundation Added: user/gjb/releng-rewrite/ - copied from r43294, head/ From gjb at FreeBSD.org Sun Dec 8 07:45:17 2013 From: gjb at FreeBSD.org (Glen Barber) Date: Sun, 8 Dec 2013 07:45:16 +0000 (UTC) Subject: svn commit: r43296 - user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng Message-ID: <201312080745.rB87jGWK055730@svn.freebsd.org> Author: gjb Date: Sun Dec 8 07:45:16 2013 New Revision: 43296 URL: http://svnweb.freebsd.org/changeset/doc/43296 Log: Add freebsd-releng/ article directory. Sponsored by: The FreeBSD Foundation Added: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/ From gjb at FreeBSD.org Sun Dec 8 08:02:52 2013 From: gjb at FreeBSD.org (Glen Barber) Date: Sun, 8 Dec 2013 08:02:51 +0000 (UTC) Subject: svn commit: r43297 - user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng Message-ID: <201312080802.rB882pXB062526@svn.freebsd.org> Author: gjb Date: Sun Dec 8 08:02:51 2013 New Revision: 43297 URL: http://svnweb.freebsd.org/changeset/doc/43297 Log: Add work-in-progress release engineering docs. Sponsored by: The FreeBSD Foundation Added: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/Makefile (contents, props changed) user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/article.xml (contents, props changed) user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/extra.css (contents, props changed) Added: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/Makefile ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/Makefile Sun Dec 8 08:02:51 2013 (r43297) @@ -0,0 +1,21 @@ +# +# $FreeBSD$ +# +# Article: FreeBSD Release Engineering + +DOC?= article + +FORMATS?= html +WITH_ARTICLE_TOC?= YES + +INSTALL_COMPRESSED?= gz +INSTALL_ONLY_COMPRESSED?= + +SRCS= article.xml + +CSS_SHEET_ADDITIONS= extra.css + +URL_RELPREFIX?= ../../../.. +DOC_PREFIX?= ${.CURDIR}/../../.. + +.include "${DOC_PREFIX}/share/mk/doc.project.mk" Added: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/article.xml ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/article.xml Sun Dec 8 08:02:51 2013 (r43297) @@ -0,0 +1,189 @@ + + + + + + +]> +
+ + &os; Release Engineering + + + &tm-attrib.freebsd; + &tm-attrib.intel; + &tm-attrib.general; + + + $FreeBSD$ + + + This article describes the release engineering process of + the &os; Project. + + + + + Introduction to the &os; Release Engineering + Process + + Development of &os; has a very specific workflow. In + general, all changes to the &os; base system are committed to + the head/ branch, which reflects the top of + the source tree. + + After a reasonable testing period, changes can then be + merged to the stable/ branches. The default + minimum timeframe before merging to stable/ + branches is three (3) days. + + Although a general rule to wait a minimum of three days + before mergeing from head/, there are a few + special circumstances where an immediate merge may be necessary, + such as a critical security fix, or a bug fix that directly + inhibits the release build process. + + After several months, and the number of changes in the + stable/ branch have grown significantly, it + is time to release the next version of &os;. These releases + have been historically referred to as point + releases. + + In between releases from the stable/ + branches, approximately every two (2) years, a release will be + cut directly from head/. These releases + have been historically referred to as dot-zero + releases. + + This article will highlight the workflow and + responsibilities of the &team.re; for both + dot-zero and point' + releases. + + The following sections of this article describe: + + + + + + + General information and preparation before + starting the release cycle. + + + + + + + + The Release Engineering process for a + dot-zero release. + + + + + + + + The Release Engineering process for a + point release. + + + + + + + General Information and Preparation + + Approximately two months before the start of the release + cycle, the &team.re; decides on a schedule for the release. + The schedule includes the various milestone points of the + release cycle, such as freeze dates, branch dates, and build + dates. For example: + + + + + + Milestone + Anticipated Date + + + + + + head/ slush: + August 24 + + + + head/ freeze: + September 7 + + + + head/ KBI freeze: + September 21 + + + + stable/10/ + branch: + October 10 + + + + BETA1 build starts: + October 12 + + + + BETA2 build starts: + October 18 + + + + releng/10.0/ + branch: + November 1 + + + + RC1 build starts: + November 1 + + + + RC2 build starts: + November 9 + + + + RELEASE build starts: + November 19 + + + + + + After general agreement on the schedule, the &team.re; + emails the the schedule to the &os; Developers. + + + + Release from <literal>head/</literal> + +   + + + + + Release from <literal>stable/</literal> + +   + + +
Added: user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/extra.css ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng/extra.css Sun Dec 8 08:02:51 2013 (r43297) @@ -0,0 +1,7 @@ +/* + * $FreeBSD$ + */ + +DIV.TITLEPAGE { + text-align: center; +}