Date: Thu, 14 Sep 2000 17:06:26 +0100 From: Nik Clayton <nik@freebsd.org> To: Garrett Rooney <rooneg@electricjellyfish.net>, Sean Michael Whipkey <highway@cstone.net>, Eric Hedstrom <erich@peregrine.com>, Jon Hamilton <hamilton@pobox.com>, Joseph Scott <joseph.scott@owp.csus.edu>, Nick Slager <nicks@albury.net.au>, Jason George <jbg@resourcechain.com>, doc@freebsd.org Subject: A quick conspectus FAQ Message-ID: <20000914170625.G440@canyon.nothing-going-on.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000914170625.G440>