From owner-svn-doc-user@FreeBSD.ORG Sun Dec 8 08:02:52 2013 Return-Path: Delivered-To: svn-doc-user@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 8E522AB2; Sun, 8 Dec 2013 08:02:52 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 695771AEC; Sun, 8 Dec 2013 08:02:52 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id rB882qpl062529; Sun, 8 Dec 2013 08:02:52 GMT (envelope-from gjb@svn.freebsd.org) Received: (from gjb@localhost) by svn.freebsd.org (8.14.7/8.14.7/Submit) id rB882pXB062526; Sun, 8 Dec 2013 08:02:51 GMT (envelope-from gjb@svn.freebsd.org) Message-Id: <201312080802.rB882pXB062526@svn.freebsd.org> From: Glen Barber Date: Sun, 8 Dec 2013 08:02:51 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-user@freebsd.org Subject: svn commit: r43297 - user/gjb/releng-rewrite/en_US.ISO8859-1/articles/freebsd-releng X-SVN-Group: doc-user MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-user@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for doc experimental trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 08 Dec 2013 08:02:52 -0000 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; +}