From owner-freebsd-doc@FreeBSD.ORG Mon Jan 20 20:28:22 2014 Return-Path: Delivered-To: freebsd-doc@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 283E4C4A; Mon, 20 Jan 2014 20:28:22 +0000 (UTC) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id B49FF175E; Mon, 20 Jan 2014 20:28:21 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id s0KKSKCc047197; Mon, 20 Jan 2014 13:28:20 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id s0KKSK08047194; Mon, 20 Jan 2014 13:28:20 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Mon, 20 Jan 2014 13:28:20 -0700 (MST) From: Warren Block To: Charlie Subject: Re: Handbook Section 25.2.3.3 Error In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Mon, 20 Jan 2014 13:28:20 -0700 (MST) Cc: freebsd-doc@freebsd.org, wblock@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Jan 2014 20:28:22 -0000 On Mon, 20 Jan 2014, Charlie wrote: > Greetings all, > > First, I want to say "hi," and that I am excited to be part of the FreeBSD > community. I am not much of a developer, but I have been wanting to help out > with the project for a few months now, so I figured I could probably try > helping with documentation. > > While upgrading a box to 10.0-RELEASE today, I happened to glance over the > Handbook page on upgrading FreeBSD, and I believe there is a mistake in > section 25.2.3.3, "Rebuilding Ports After a Major Version Upgrade." > > www5.us.freebsd.org/doc/handbook/updating-upgrading-freebsdupdate.html > > The portmaster command listed is 'portmaster -f', but I believe it should be > 'portmaster -af'. Agreed, change committed. > Once again, I look forward to helping with the project. I am pretty good at > writing, but not so great at coding and software development, so if there are > any small projects that I might be able to work on, I'd be interested in > learning more. Welcome! As with all documentation, there is always room for improvement. For an in-depth look at how the FreeBSD documentation works, we have the FDP Primer: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ There is a lot there, don't let it overwhelm you. As far as projects, there are numerous open problem reports in the doc category: http://www.freebsd.org/cgi/query-pr-summary.cgi?category=docs Another approach is to just to report errors you've found, like you did above. It's usually best to file those as problem reports in the bug tracking system so they don't get lost: http://www.freebsd.org/support/bugreports.html Problem reports with patches are particularly prized because they can be quickly evaluated and committed. If you have questions or comments, you can post here or ask on IRC (#bsddocs on EFnet). Thanks!