From owner-freebsd-stable@FreeBSD.ORG Wed Aug 1 04:39:49 2012 Return-Path: Delivered-To: freebsd-stable@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id E35E31065672 for ; Wed, 1 Aug 2012 04:39:49 +0000 (UTC) (envelope-from kob6558@gmail.com) Received: from mail-wg0-f50.google.com (mail-wg0-f50.google.com [74.125.82.50]) by mx1.freebsd.org (Postfix) with ESMTP id 760BA8FC0C for ; Wed, 1 Aug 2012 04:39:49 +0000 (UTC) Received: by wgbds11 with SMTP id ds11so6260595wgb.31 for ; Tue, 31 Jul 2012 21:39:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=pbqAGVys0pedwWPTroyzJ6g7yLDWz+Cagtk0UeLl7cw=; b=LhOOehdy/5AtmT9ugluwpQHxJ3KfLXQylmQr7bt+QCTrciYy65lpqYvTwbiahUl0Sr RkwuNobfqHCUbeQO5yS/j3mhdyoF5nb3nmgRHZSDSVaML6shf+5/gUsqKD6uQSGjGlv/ RtmOgqdYEWwwQEwc61eIC5Y3RAeCJbyuY+cbSmsh1UTmB6K5FSIqlN7n4pgNTrtpIb16 1m1rLb+TCLh8YiyEPf4aTe2vGeH79z26mNpWLj8obN2ShaDzXe1UnpSg07M85xO2a8Wu 8FgmSs/3xFhlwS5V8GrEG7eyQL5QWQMxsoIfeGhVMsVe36BgMJjMKGqebHY6pNOotZpf uZoA== MIME-Version: 1.0 Received: by 10.180.96.3 with SMTP id do3mr13214166wib.5.1343795988508; Tue, 31 Jul 2012 21:39:48 -0700 (PDT) Received: by 10.223.60.147 with HTTP; Tue, 31 Jul 2012 21:39:48 -0700 (PDT) In-Reply-To: <50187DEB.2090906@ish.com.au> References: <50187DEB.2090906@ish.com.au> Date: Tue, 31 Jul 2012 21:39:48 -0700 Message-ID: From: Kevin Oberman To: Aristedes Maniatis Content-Type: text/plain; charset=UTF-8 Cc: freebsd-stable Subject: Re: release documentation confusing for 9.1 X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 01 Aug 2012 04:39:50 -0000 On Tue, Jul 31, 2012 at 5:52 PM, Aristedes Maniatis wrote: > Could I ask that someone with appropriate access rights review the state of > release documentation for 9.1 beta. It is very confused. > > > 1. This page is the best information available: > http://www.freebsd.org/releases/9.1R/schedule.html > > 2. The link from the front page ( http://www.freebsd.org/ ) is labelled > "Upcoming: 9.1-BETA1" but goes to a page which is mostly about existing > releases, not the next release. http://www.freebsd.org/where.html#helptest > > 3. Clicking on the "view" link for the 9.1 information on that page takes > you to http://wiki.freebsd.org/Releng/9.1TODO which looks a lot like the > information in point [1] but wrong/old. > > 4. On http://www.freebsd.org/where.html#helptest there is a link to "FreeBSD > Snapshot Releases" for people interested in "FreeBSD-CURRENT (AKA > 10.0-CURRENT)". But following the link takes you to a page where you get > linked to "9-CURRENT, 8-STABLE, 7-STABLE, and 6-STABLE" snapshots. > > > > It is possible I'm just stuck in the past, but I've never been able to > navigate the 'new' bowling ball branded FreeBSD site nearly as well as the > older incarnation. And yes, I can eventually figure it all out... but this > information could be a whole lot clearer. I design information presentation > for a living, so perhaps I'm picky about these things, but I do think that > confusion could turn people away from my favourite operating system. > > I'm happy to help if someone wants to enlist my assistance, but I don't > currently have any commit rights on this project. RE has not done very well in updating this stuff for several releases. RE is a very hard job and I understand that they are busy with both 9.1 and $REAL_JOB. I'd love for them to find someone whom they trust and with reasonable clue to whom they could give the right to update all of this stuff. It would still lag a bit, but it would be closer. As far as what will be in 9.1, the doc tree was tagged for 9.1 two days ago and can be downloaded from svn or cvs and built. Note that it's all in sgml and you need to build the various formats. I'm not sure when they will hit the web site and, of course, noting is official until the release, but it is unlikely to change at this point except for minor corrections. -- R. Kevin Oberman, Network Engineer E-mail: kob6558@gmail.com