From owner-freebsd-doc@FreeBSD.ORG Sun Nov 4 19:40:05 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 6445BDF4 for ; Sun, 4 Nov 2012 19:40:05 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-lb0-f182.google.com (mail-lb0-f182.google.com [209.85.217.182]) by mx1.freebsd.org (Postfix) with ESMTP id C32F08FC0A for ; Sun, 4 Nov 2012 19:40:04 +0000 (UTC) Received: by mail-lb0-f182.google.com with SMTP id b5so4648587lbd.13 for ; Sun, 04 Nov 2012 11:40:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :content-type; bh=AzLXJSEcOgbvcuuCb7sTd2LxpITx4g13C3Ts1gfRh50=; b=duLjB9Wk6PNmWC5deY/6lGoa4UsOnqur4FsXpTZPzHWNdEfWI0PwjpfYKMDnoW2Y3j wflOWD1t72193JVMhZMEe9K9tCdibj+HgsdM7AhXypDglyCkeVDUy7U6UL01ojbfbIw5 roMkRIGX/MJRNak75ypnvUjvCgsIfogcPlnZ4= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :content-type:x-gm-message-state; bh=AzLXJSEcOgbvcuuCb7sTd2LxpITx4g13C3Ts1gfRh50=; b=coMeN1gsZ3kiEQQ0nODC99COf68TcIWNjseU1QXp5KJvvX/PzjMmwtPdZUtHf8io6W l1oJXpp+ODyDr+WggQYHGipqRbwiyVJ5dua0IRc8Wsz09fqegVG3Cg2+j28L5v/thpgb c0LuX+AhlCoU+ZFTtB8ZPa5gG+G6nBe2XpRnXGJDUz73MZk28Oj+mSq7NBNLt5+tPghQ TnLT56M4YNqItOFwXn7YsHNeBF2iOH9Q9Ok5bPhah70/5WWNCcYEyn2SKovzuxpj6h7G I8rkIrVET1NjhGTXh0DyBa8qWQvhaOFAU57LfNL9iOo5Ca286kY4OyMWz5TQLaLMhqKL rqLQ== Received: by 10.112.104.2 with SMTP id ga2mr3196134lbb.48.1352058003147; Sun, 04 Nov 2012 11:40:03 -0800 (PST) MIME-Version: 1.0 Received: by 10.112.25.166 with HTTP; Sun, 4 Nov 2012 11:39:31 -0800 (PST) In-Reply-To: References: From: Eitan Adler Date: Sun, 4 Nov 2012 14:39:31 -0500 Message-ID: Subject: what's the deal with changing release notes? To: FBSD Doc project Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQkSt8VK31PFwZbC46JOldG/Hok9Y+yv/su10k5X8TKOC2WhNPCBW7ow9+Imvnm2rLI265fp X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 04 Nov 2012 19:40:05 -0000 I'd like to commit the following patch but have been told that changing release notes is special and they aren't supposed to be changed once published. Why is this? Right now some release notes have a "bug" and have already caused two PRs which is (a) a waste of time for the project and (b) likely means that many times that number have seen it and gotten annoyed. It also looks completely unprofessional. What's the actual policy on changing release notes, and why? commit bfe955ef84302132ae222dd1e15615b0af5554a3 Author: Eitan Adler Date: Thu Nov 1 19:45:10 2012 -0400 Fix odd quoting in the release announcmenets: there have already been two PRs about this. It also looks odd and unprofessional. PR: docs/172928 Submitted by: "A.AUDEBERT" Discussed with: brooks Approved by: ??? (mentor) diff --git a/en_US.ISO8859-1/htdocs/releases/8.3R/announce.xml b/en_US.ISO8859-1/htdocs/releases/8.3R/announce.xml index 1badd72..6036ee7 100644 --- a/en_US.ISO8859-1/htdocs/releases/8.3R/announce.xml +++ b/en_US.ISO8859-1/htdocs/releases/8.3R/announce.xml @@ -110,7 +110,7 @@ USB drive appears as /dev/da0 on your machine something like this should work:

- 
# dd if="FreeBSD"-8.3-RELEASE-amd64-memstick.img
of=/dev/da0 bs="10240" conv="sync"
+ 
# dd if="FreeBSD-8.3-RELEASE-amd64-memstick.img"
of=/dev/da0 bs="10240" conv="sync"

Be careful to make sure you get the target (of=) correct.

diff --git a/en_US.ISO8859-1/htdocs/releases/9.0R/announce.xml b/en_US.ISO8859-1/htdocs/releases/9.0R/announce.xml index 0567904..b93339a 100644 --- a/en_US.ISO8859-1/htdocs/releases/9.0R/announce.xml +++ b/en_US.ISO8859-1/htdocs/releases/9.0R/announce.xml @@ -152,7 +152,7 @@ USB drive appears as /dev/da0 on your machine something like this should work:

- 
# dd if="FreeBSD"-9.0-RELEASE-amd64-memstick.img
of=/dev/da0 bs="10240" conv="sync"
+ 
# dd if="FreeBSD-9.0-RELEASE-amd64-memstick.img"
of=/dev/da0 bs="10240" conv="sync"

Be careful to make sure you get the target (of=) correct.

-- Eitan Adler