From owner-freebsd-doc@FreeBSD.ORG Tue May 27 21:56:19 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6AE981065672; Tue, 27 May 2008 21:56:19 +0000 (UTC) (envelope-from sonicy@otenet.gr) Received: from rosebud.otenet.gr (rosebud.otenet.gr [195.170.0.94]) by mx1.freebsd.org (Postfix) with ESMTP id E73008FC12; Tue, 27 May 2008 21:56:18 +0000 (UTC) (envelope-from sonicy@otenet.gr) Received: from aquarius.dyndns.org (athedsl-08121.home.otenet.gr [87.202.31.247]) by rosebud.otenet.gr (8.13.8/8.13.8/Debian-3) with ESMTP id m4RLuGcQ008210; Wed, 28 May 2008 00:56:17 +0300 Message-ID: <483C83D1.40609@otenet.gr> Date: Wed, 28 May 2008 00:57:37 +0300 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.14 (X11/20080501) MIME-Version: 1.0 To: Hiroki Sato References: <483C6E04.3070804@otenet.gr> <20080528.060009.127260270.hrs@allbsd.org> <483C7AD4.5090409@otenet.gr> <20080528.063631.13709725.hrs@allbsd.org> In-Reply-To: <20080528.063631.13709725.hrs@allbsd.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org Subject: Re: Wiki style FAQ proposal X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 27 May 2008 21:56:19 -0000 Hiroki Sato wrote: > Manolis Kiagias wrote > in <483C7AD4.5090409@otenet.gr>: > > so> Gabor Pali actually had the nice idea that the wiki could have two areas, like a "CURRENT" and "STABLE" branch. More people could contribute in the current branch, and then the maintainer(s) could move what would be considered more valuable content to the 'stable' branch. This would also mean there is enough quality control and the whole thing does not become disorganized. > > Two quick questions. You mean wiki holds entire copy of the FAQ > entries? My understanding is that we have to edit "CURRENT", move it > to "STABLE", and move it to the static version out of the wiki > ("STABLE") finally. Is that right? I vaguely feel this needs a lot > of care and prevents quick update. > The 'current' will only be for new content or even categories, for entries that have not been checked for correctness / validity and so on. The 'stable' branch will have more or less established categories and entries (which will be updated regularly) and when new stuff from current gets reviewed and considered important, it should be added to stable. The idea here is that current will be more or less open to contributions from everyone. Seasoned maintainers will be able to change articles in stable directly. We will not have an MFC for everything. This would really slow it down. Of course, it still is a lot of work. > The second one is that which do we publish as one the average user > should read. If all the three have whole copy of FAQ entries with > some difference from each other, the user (and even committer) will > get confused. > > -- > | Hiroki SATO > In my opinion, the sgml FAQ should be limited to questions about the project and maybe not so quickly changing technical stuff. The idea here is the sgml FAQ is used for distribution as an offline document (CDs printouts etc) and the rest should be referred to the online FAQ. There will be some duplication in the FAQ and the wiki, but the user should be encouraged to use the wiki unless there is no option (e.g. no network). As I see it we would have: - SGML FAQ: Distributed on CDs. Printing possible. Project info and some technical info. Intended mostly for offline use - Wiki 'stable': Intended for most people. Answering a broad range of technical questions and also linking to other documentation - Wiki 'current': For people willing to contribute new entries and also for searching up to the minute stuff where 'stable' is not there yet.