From owner-freebsd-doc@FreeBSD.ORG Sat Jan 6 16:10:27 2007 Return-Path: X-Original-To: doc@freebsd.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 4AED416A415 for ; Sat, 6 Jan 2007 16:10:27 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from pne-smtpout2-sn1.fre.skanova.net (pne-smtpout2-sn1.fre.skanova.net [81.228.11.159]) by mx1.freebsd.org (Postfix) with ESMTP id 11E8F13C458 for ; Sat, 6 Jan 2007 16:10:27 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from [90.224.61.244] (90.224.61.244) by pne-smtpout2-sn1.fre.skanova.net (7.2.075) id 456CB2C8007A35E2 for doc@freebsd.org; Sat, 6 Jan 2007 16:00:27 +0100 Message-ID: <459FB98E.7060209@gmail.com> Date: Sat, 06 Jan 2007 16:00:30 +0100 From: Niclas Zeising User-Agent: Thunderbird 1.5.0.9 (Windows/20061207) MIME-Version: 1.0 To: doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Subject: Changes and Updates to Installation chapter 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: Sat, 06 Jan 2007 16:10:27 -0000 This is a list of changes that I think are needed in the Installation Chapter of the Handbook. It is not a patch to the documentation or anything, I want to discuss the changes before continuing working with doing the actual changes. In short, it is mostly an update to bring the installation chapter up to speed. New screenshots from sysinstall, changes to match the reality and the current state of sysinstall, those kind of things. Some of the bigger changes is removal of alpha-specific bits, or at least add a note regarding the status of Alpha. Someone with alpha-experience need to validate that the instructions for alpha still is correct. Maybe we should add something about SPARC if there is big difference from installing on an i386/amd64. Further, it's removal of most of the X-related bits, pointing the user to the X chapter instead, since X configuration is not part of the installation procedure anymore. One note on this is that most Linux distributions comes with X pretty much setup from default installation. I think we have to have clear and precise notes on how to set up X so people not used to the command line can get their graphical interface. The biggest change I suggest is removal of most of the bits regarding networking, and putting them in some sort of "Simple networking" chapter in the networking section instead. I think we only should have instructions on how to get an internet connection up and working in the workstation sense, i. e. how to be able to surf the net and so on. WWW/FTP-servers, NFS and so on doesn't belong in an installation chapter in my opinion. I also had an idea of adding a chapter to the networking section which talks about tcp/ip-networks in general, subnetting, routing and so on. Is that too much of topic? This is just suggestions. As said before I would like some input on this before continuing to do the actual work. I have a more detailed list about what's needed to be done, but since it's mostly small fixes I realized the above summary better describes what has to be done. I can type it down and post it if someone asks for it. Regards! //Niclas