From owner-freebsd-doc@FreeBSD.ORG Wed Nov 21 16:14:10 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 8F53B4EA for ; Wed, 21 Nov 2012 16:14:10 +0000 (UTC) (envelope-from m.e.sanliturk@gmail.com) Received: from mail-vb0-f54.google.com (mail-vb0-f54.google.com [209.85.212.54]) by mx1.freebsd.org (Postfix) with ESMTP id 3B80F8FC17 for ; Wed, 21 Nov 2012 16:14:09 +0000 (UTC) Received: by mail-vb0-f54.google.com with SMTP id l1so9719179vba.13 for ; Wed, 21 Nov 2012 08:14:09 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=g3oiVo0ZrkcKm6tgsZPkBRWSrpAQl75k7nNKSl4ecoU=; b=WCVDhFMshlAqqqpDN5oBBNHlCvGIxGGAaM5y4Z29swWWwybT3OpZg6bQbYIB2m0ivT gQNtSSAapmMBH2C17w8hChaG/YOqJEe4lYxtkAKmkK+TPC1S8hmRvbCXPYhLjpZhcleG aF2WswoYpxbAdXBKuswQUQGz+K7Zei8ghJy4WR24uQRI+Kz3B4cPp86HFKTHX9ii8irP O2szxTqYEQJ8goSyTDc8VHiMhvpzd54w0U7A2Wc9N6wuvuMAi0NVMjgLw/fNHRsOYhKf W+Y7CWCuettRJiN93vtCCmQQvu9it7cIRAal8Ejl/cqrZrnLlb34l0TuxbzjNYOMfN8f dRfA== MIME-Version: 1.0 Received: by 10.58.162.130 with SMTP id ya2mr27803434veb.2.1353514449522; Wed, 21 Nov 2012 08:14:09 -0800 (PST) Received: by 10.58.218.35 with HTTP; Wed, 21 Nov 2012 08:14:09 -0800 (PST) In-Reply-To: References: Date: Wed, 21 Nov 2012 08:14:09 -0800 Message-ID: Subject: Re: The FreeBSD Corporate Networker's Guide From: Mehmet Erol Sanliturk To: Eitan Adler Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.14 Cc: doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Nov 2012 16:14:10 -0000 On Wed, Nov 21, 2012 at 7:45 AM, Eitan Adler wrote: > On 21 November 2012 03:32, Mehmet Erol Sanliturk > wrote: > > This document , when it started was very useful , but now it may be > > considered not useful . > > Agreed. > > > My suggestion is the following : > > > > ( 1) One or more people having sufficient knowledge to modify it to > satisfy > > current needs > > handle this to rewrite its required parts to describe new > > possibilities ( Samba , CUPS , etc. ) . > > This is key. An updated document is essentially a rewrite. I don't > think it is worth to keep the old document. If someone wishes to write > an article with the new technologies we can help them with the markup > and related work. > I don't see how this article will help. > > > > > (2) The Handbook contains the following section : > > > > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-samba.html > > > > The modified document may be incorporated into this section and to other > > suitable sections , and > > in that way , it may be eliminated as an independent document and be made > > living with the Handbook . > > Or we can just incorporate the new article directly into the handbook. > > > -- > Eitan Adler > When we consider the chapter http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-servers.html it is not necessary to maintain another document about networking just to increase load of people to maintain it . For that reason , usable parts of this article may be incorporated into the above chapter and information about the new networking state may be added and this article may be eliminated completely . If it is modernized and left alone , over time again it will become outdated because it is very likely that it will not be utilized very much as it is understood from its existent state . The Handbook is a required and used document and it is continuously updated . Actually , cooperation among contributors may be very useful in the following sense : Assume that a person has sufficient knowledge to rewrite some parts . He or she prepares a plain text document containing the necessary information . Another person knowing very well how to develop a web page , converts that text document to a suitable web page even he or she does not know semantics of the content . It is difficult to find a person that knows "everything well" and has "time unlimited" . Thank you very much . Mehmet Erol Sanliturk