Date: Tue, 27 May 2008 23:24:36 +0300 From: Manolis Kiagias <sonicy@otenet.gr> To: freebsd-doc@freebsd.org Subject: Wiki style FAQ proposal Message-ID: <483C6E04.3070804@otenet.gr> In-Reply-To: <483B92D1.4040500@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>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?483C6E04.3070804>