From owner-freebsd-doc@FreeBSD.ORG Mon Oct 23 12:56:00 2006 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 83FA116A407 for ; Mon, 23 Oct 2006 12:56:00 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4D20743D58 for ; Mon, 23 Oct 2006 12:55:59 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from gothmog.pc (host5.bedc.ondsl.gr [62.103.39.229]) (authenticated bits=128) by igloo.linux.gr (8.13.8/8.13.8/Debian-2) with ESMTP id k9NCt9wK010671 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 23 Oct 2006 15:55:13 +0300 Received: from gothmog.pc (gothmog [127.0.0.1]) by gothmog.pc (8.13.8/8.13.8) with ESMTP id k9NCtjcN001855; Mon, 23 Oct 2006 15:55:45 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.pc (8.13.8/8.13.8/Submit) id k9NCtiDN001854; Mon, 23 Oct 2006 15:55:44 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Mon, 23 Oct 2006 15:55:44 +0300 From: Giorgos Keramidas To: Yar Tikhiy Message-ID: <20061023125544.GA1788@gothmog.pc> References: <20061015173531.GB31717@comp.chem.msu.su> <20061018225653.GA1332@gothmog.pc> <20061023115629.GB87535@comp.chem.msu.su> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20061023115629.GB87535@comp.chem.msu.su> X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (score=-2.653, required 5, AWL -0.26, BAYES_00 -2.60, DNS_FROM_RFC_ABUSE 0.20, UNPARSEABLE_RELAY 0.00) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@freebsd.org Subject: Re: New article 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: Mon, 23 Oct 2006 12:56:00 -0000 On 2006-10-23 15:56, Yar Tikhiy wrote: > On Thu, Oct 19, 2006 at 01:56:53AM +0300, Giorgos Keramidas wrote: > > On 2006-10-15 21:35, Yar Tikhiy wrote: > > > Hi folks, > > > > > > I wrote an article on our rc.d subsystem. Its draft in sgml and > > > html is available at http://people.freebsd.org/~yar/rcng/ . It has > > > been reviewed on freebsd-rc. Now I'd like to add it to our article > > > collection. I see that I should commit the article itself, then > > > update www/docs/books.sgml. What else? > > > > > > P.S. Please feel free to review my article WRT its markup. Thanks! > > > > Hi Yar, > > > > First of all, *THANKS*! > > > > This is a great article, and I really enjoyed reading it. One of my > > latest commits to doc/ was, in fact, inspired by this article: > > I'm much pleased to hear that my humble work was useful to you! > > > Having said that, as I was going through the article, I noticed a few > > places where I would probably word things in a slightly different way. > > I am not sure if all my changes are ok, but the attached patch shows all > > the changes I have made locally. > > Thank you for the patch! Although I didn't apply all its parts > verbatim, the patch showed me quite a number of rough corners still > in my article. I did my best to polish them. > > The revised version is ready at http://people.freebsd.org/~yar/rcng/ . Nice. Let's not waste too much time in nit-picking then. Please go ahead, and commit it when you are ready :) > > This is still a work-in-progress, as I am going a second time through > > the article, looking for things which I would write in a different way, > > or for things which seem cool to add. I'm not done, yet, but here is a > > first patch version, so we can work in parallel ;) > > Your help is much appreciated! > > > If you like any of the changes, feel free to import them in your own > > copy of the article. Please, also let em know if you need help while > > committing this to doc/. > > I can commit to doc by myself, and I'd like to, but would you mind > telling me what I should do apart from committing the article itself, > connecting it to the build via ../Makefile, and adding a reference > to the Books & Articles Online webpage? AFAIK, in general, the process of adding a new article is: 1. Commit the article under doc/en_US.ISO8859-7/articles/rcng/* 2. Add a SUBDIR entry to doc/en_US.ISO8859-7/articles/Makefile 3. Add a reference to the new article to www/en/docs/books.sgml > By the way, what short title would you suggest for the article? Does > "rc-scripting" look good? "The System Startup Scripts of FreeBSD" seems short to me. I'm not sure what you mean by "short title" though.