From owner-freebsd-doc@FreeBSD.ORG Wed Jun 18 14:47:18 2014 Return-Path: Delivered-To: freebsd-doc@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 A426A901 for ; Wed, 18 Jun 2014 14:47:18 +0000 (UTC) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "wonkity.com", Issuer "wonkity.com" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 3760E2C12 for ; Wed, 18 Jun 2014 14:47:17 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.9/8.14.9) with ESMTP id s5IElGYc047418 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Wed, 18 Jun 2014 08:47:16 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.9/8.14.9/Submit) with ESMTP id s5IElG5s047415; Wed, 18 Jun 2014 08:47:16 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Wed, 18 Jun 2014 08:47:16 -0600 (MDT) From: Warren Block To: Anders Jensen-Waud Subject: Re: Contributing to documentation In-Reply-To: <20140618040551.GC50405@koodekoo.local> Message-ID: References: <20140618040551.GC50405@koodekoo.local> User-Agent: Alpine 2.11 (BSF 23 2013-08-11) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Wed, 18 Jun 2014 08:47:16 -0600 (MDT) Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Jun 2014 14:47:18 -0000 On Wed, 18 Jun 2014, Anders Jensen-Waud wrote: > Hello, > > I am a long-time avid FreeBSD user (from memory since FreeBSD 4.0). I have for very > long been interested in contributing back to the FreeBSD community. > > I was wondering what the current needs are in terms of improving > documentation and gaps where help is needed? I checked out the IdeaList > on the FreeBSD Wiki but it seems somewhat outdated (a lot of the > links are dead). Would anyone be able to shed some light on where I > might be able to contribute? > > Ideas I had thought of: > > 1. Undertaking Handbook translation to Danish (it is my mother's tongue) > 2. Writing new chapters for the Handbook Thank you! Help is always appreciated, and always needed! Both of the projects suggested are fairly large. I'd suggest doing at least a couple of smaller things first to become familiar with how the documentation system works. Fortunately, there are always plenty of small projects available. We have a book that describes how the different documentation systems work: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/book.html To make getting started easier, see the quick start section: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/book.html#overview-quick-start It helps to be familiar with source control systems or DocBook, but is not required. There might be some small aspect of the documentation that you have noticed before with simple errors like misspellings or outdated details. There are also doc bugs in the bug database: https://bugs.freebsd.org/bugzilla/buglist.cgi?component=Documentation&list_id=5825&product=Documentation&resolution=--- Members of the doc team are available to provide help. The quickest response to questions is probably through IRC, on the #bsddocs channel on EFnet. Email to this mailing list works also.