From owner-freebsd-doc@FreeBSD.ORG Tue May 27 20:23: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 B5C08106566B for ; Tue, 27 May 2008 20:23: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 3CF918FC19 for ; Tue, 27 May 2008 20:23: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 m4RKNFwK017324 for ; Tue, 27 May 2008 23:23:16 +0300 Message-ID: <483C6E04.3070804@otenet.gr> Date: Tue, 27 May 2008 23:24:36 +0300 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.14 (X11/20080501) MIME-Version: 1.0 To: freebsd-doc@freebsd.org References: <4839B6E6.8040706@kovesdan.org> <4839E1BE.4080803@otenet.gr> <483AEC99.2060202@FreeBSD.org> <483B10BE.1070903@otenet.gr> <483B36C6.3020608@FreeBSD.org> <483B3E98.6040804@otenet.gr> <483B92D1.4040500@FreeBSD.org> In-Reply-To: <483B92D1.4040500@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Subject: 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 20:23:19 -0000 Hey all, Gabor Pali and myself have been translating the FAQ to Hungarian / Greek for some time now. During the course of this work, we noticed there is a lot of outdated technical info, that only applies to older outdated versions of FreeBSD and possibly obsolete hardware. Mark Linimon suggested to me there was a plan to move at least the technical info of the FAQ into a form that could be more easily updated, such as a wiki. Apparently these plans did not go forward due to lack of time. Gabor Kovesdan noted that a wiki is better as a developer scratchpad rather than real documentation and expressed the (valid) concern that a wiki cannot be distributed (for example on CD) like the current SGML based FAQ. Some ideas / proposals related to the above: - Create a wiki style FAQ (while still maintaining the current version of the FAQ) with a possible future plan to limit the original SGML FAQ to questions related to the way the Project works, rather than technical stuff. - Maintain the current FAQ as is, and also create a wiki that will serve for the most up-to-date technical questions. Periodically, these could also be used to update the SGML version of the FAQ, or (if possible) the wiki could be converted in a way to static content so it becomes re-distributable. We believe experimenting with a wiki style FAQ (regardless of what is decided about the SGML FAQ) is a good idea, since more people will be able to get involved and the information will be much more current and useful. We also realize there maybe several drawbacks to it: 1) Not really distributable (as mentioned above) 2) Good administration will be needed so the organization of categories and content does not become 'chaotic' In the light of the above, we would like to hear the community's and the committers' ideas and proposals on the above plans. Thanks, Manolis Kiagias