From nobody@FreeBSD.org  Fri Mar 28 13:10:57 2014
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id EEB11845
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 28 Mar 2014 13:10:57 +0000 (UTC)
Received: from cgiserv.freebsd.org (cgiserv.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(Client did not present a certificate)
	by mx1.freebsd.org (Postfix) with ESMTPS id DA02EB1C
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 28 Mar 2014 13:10:57 +0000 (UTC)
Received: from cgiserv.freebsd.org ([127.0.1.6])
	by cgiserv.freebsd.org (8.14.8/8.14.8) with ESMTP id s2SDAvwO015050
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 28 Mar 2014 13:10:57 GMT
	(envelope-from nobody@cgiserv.freebsd.org)
Received: (from nobody@localhost)
	by cgiserv.freebsd.org (8.14.8/8.14.8/Submit) id s2SDAvqJ015049;
	Fri, 28 Mar 2014 13:10:57 GMT
	(envelope-from nobody)
Message-Id: <201403281310.s2SDAvqJ015049@cgiserv.freebsd.org>
Date: Fri, 28 Mar 2014 13:10:57 GMT
From: Kim Lesmer <knl@bitflop.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Contradictions between the FAQ and the Handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         188031
>Category:       advocacy
>Synopsis:       Contradictions between the FAQ and the Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-advocacy
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 28 13:20:00 UTC 2014
>Closed-Date:    
>Last-Modified:  Fri Mar 28 15:10:00 UTC 2014
>Originator:     Kim Lesmer
>Release:        10
>Organization:
>Environment:
>Description:
On the FAQ here: https://www.freebsd.org/doc/faq/introduction.html

It says, when explaining the different releases:

"Briefly, -STABLE is aimed at the ISP, corporate user, or any user who wants stability and a minimal number of changes compared to the new (and possibly unstable) features of the latest -CURRENT snapshot."

This is highly contradictory to the information provided several places in the Hanbook.

For example:

http://www.freebsd.org/doc/handbook/current-stable.html

"This is still a development branch and, at any given time, the sources for FreeBSD-STABLE may or may not be suitable for general use. It is simply another engineering development track, not a resource for end-users."


>How-To-Repeat:

>Fix:
I think having a FAQ section outside of the Handbook is a problem. It would be better, easier to keep track of things, if the FAQ is moved to the Handbook and then the above information corrected.

>Release-Note:
>Audit-Trail:

From: Andrew Moseman <Andrew.Moseman@pomeroy.com>
To: Kim Lesmer <knl@bitflop.com>, "freebsd-gnats-submit@FreeBSD.org"
	<freebsd-gnats-submit@FreeBSD.org>
Cc:  
Subject: RE: advocacy/188031: Contradictions between the FAQ and the Handbook
Date: Fri, 28 Mar 2014 13:32:55 +0000

 Good catch Kim,
 
 Another suggestion would be to link the FAQ to the hand book or vice versa =
 and manage only one definition.
 
 -----Original Message-----
 From: owner-freebsd-advocacy@freebsd.org [mailto:owner-freebsd-advocacy@fre=
 ebsd.org] On Behalf Of Kim Lesmer
 Sent: Friday, March 28, 2014 9:11 AM
 To: freebsd-gnats-submit@FreeBSD.org
 Subject: advocacy/188031: Contradictions between the FAQ and the Handbook
 
 
 >Number:         188031
 >Category:       advocacy
 >Synopsis:       Contradictions between the FAQ and the Handbook
 >Confidential:   no
 >Severity:       non-critical
 >Priority:       low
 >Responsible:    freebsd-advocacy
 >State:          open
 >Quarter:       =20
 >Keywords:      =20
 >Date-Required:
 >Class:          doc-bug
 >Submitter-Id:   current-users
 >Arrival-Date:   Fri Mar 28 13:20:00 UTC 2014
 >Closed-Date:
 >Last-Modified:
 >Originator:     Kim Lesmer
 >Release:        10
 >Organization:
 >Environment:
 >Description:
 On the FAQ here: https://www.freebsd.org/doc/faq/introduction.html
 
 It says, when explaining the different releases:
 
 "Briefly, -STABLE is aimed at the ISP, corporate user, or any user who want=
 s stability and a minimal number of changes compared to the new (and possib=
 ly unstable) features of the latest -CURRENT snapshot."
 
 This is highly contradictory to the information provided several places in =
 the Hanbook.
 
 For example:
 
 http://www.freebsd.org/doc/handbook/current-stable.html
 
 "This is still a development branch and, at any given time, the sources for=
  FreeBSD-STABLE may or may not be suitable for general use. It is simply an=
 other engineering development track, not a resource for end-users."
 
 
 >How-To-Repeat:
 
 >Fix:
 I think having a FAQ section outside of the Handbook is a problem. It would=
  be better, easier to keep track of things, if the FAQ is moved to the Hand=
 book and then the above information corrected.
 
 >Release-Note:
 >Audit-Trail:
 >Unformatted:
 _______________________________________________
 freebsd-advocacy@freebsd.org mailing list http://lists.freebsd.org/mailman/=
 listinfo/freebsd-advocacy
 To unsubscribe, send any mail to "freebsd-advocacy-unsubscribe@freebsd.org"
 

From: Eitan Adler <lists@eitanadler.com>
To: Andrew Moseman <Andrew.Moseman@pomeroy.com>, bug-followup <bug-followup@freebsd.org>
Cc: freebsd-advocacy@freebsd.org
Subject: Re: advocacy/188031: Contradictions between the FAQ and the Handbook
Date: Fri, 28 Mar 2014 08:05:11 -0700

 FWIW the handbook is correct: -stable is a development branch.
 
 -- 
 Eitan Adler
>Unformatted:
