Date: Mon, 23 Oct 2006 15:55:44 +0300 From: Giorgos Keramidas <keramida@freebsd.org> To: Yar Tikhiy <yar@comp.chem.msu.su> Cc: freebsd-doc@freebsd.org Subject: Re: New article Message-ID: <20061023125544.GA1788@gothmog.pc> In-Reply-To: <20061023115629.GB87535@comp.chem.msu.su> References: <20061015173531.GB31717@comp.chem.msu.su> <20061018225653.GA1332@gothmog.pc> <20061023115629.GB87535@comp.chem.msu.su>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2006-10-23 15:56, Yar Tikhiy <yar@comp.chem.msu.su> wrote: > On Thu, Oct 19, 2006 at 01:56:53AM +0300, Giorgos Keramidas wrote: > > On 2006-10-15 21:35, Yar Tikhiy <yar@comp.chem.msu.su> 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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20061023125544.GA1788>