From owner-freebsd-doc Thu Sep 14 9: 7:59 2000 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 391A337B423 for ; Thu, 14 Sep 2000 09:07:53 -0700 (PDT) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.0/8.11.0) id e8EG6S348969; Thu, 14 Sep 2000 17:06:28 +0100 (BST) (envelope-from nik) Date: Thu, 14 Sep 2000 17:06:26 +0100 From: Nik Clayton To: Garrett Rooney , Sean Michael Whipkey , Eric Hedstrom , Jon Hamilton , Joseph Scott , Nick Slager , Jason George , doc@freebsd.org Subject: A quick conspectus FAQ Message-ID: <20000914170625.G440@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi chaps, Sorry for the inpersonal nature of this e-mail, but a bunch of people have responded to my request for a conspectus for the -mobile list. I'm doing this to save my fingers from the excessive typing. I'm sending this to -doc as well, in case anyone else is interested. A number of questions have cropped up. Q: Is this only for -mobile? A: No. If you want to produce a conspectus for one of the other mailing lists then please do so. All I ask is that you coordinate through me (or the -doc mailing list) so that we don't get duplication of effort. Q: How far behind does the conspectus lag the mailing list it shadows? A: Ideally, 3 days to a week or so behind the contents of the mailing list. More delay is allowed, but the longer it gets, the less apropos it is. Q: What directory structure and layout should the files take? A: Take a look at the layout and .sgml files at http://www.freebsd.org/cgi/cvsweb.cgi/www/en/conspectus/ In particular, the README file in that directory is the notes I wrote to myself when I was taking updates for the -stable Conspectus. Q: What files should I submit? A: The less work I have to do the better :-) Ideally, you'll be able to send me the .sgml file for the week's conspectus, and patches to the index.sgml and Makefile's to integrate them in to the FreeBSD web site. I can then drop them in to the web tree, check they build OK, and commit them. From my point of view they *have* to be capable of being dropped in to the www/ CVS tree without any intervention from me, otherwise I won't know that you're going to be able to do this as a committer. Q: SGML is hard. Can't I just send you HTML? A: I'd rather not. If you look at the existing .sgml files you'll discover that they're almost entirely bog-standard HTML anyway (sufficiently so that you can rename them to a .html extension and load them in to your browser). Q: Are you serious about the volunteers becoming committers? A: Absolutely. Just demonstrate the ability to produce the conspectus on time, and in a format that's ready to be committed. There are numerous people with @freebsd.org addresses now that can testify to my eagerness to reduce my workload by bringing other people on board. Everyone that's volunteered to do one for -mobile is on this to: line of this message, and some of you have volunteered for other lists as well. Please talk amongst yourselves to determine who wants to do which list, and how you want to collaborate if more than one of you wants to do the same list -- I'd actually encourage that, so that when someone wants to go on holiday the conspectus doesn't dry up. OK? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message