Date: Tue, 18 Jul 2000 12:20:01 -0700 (PDT) From: Brooks Davis <brooks@one-eyed-alien.net> To: freebsd-doc@freebsd.org Subject: Re: docs/20009: [PATCH] the FAQ needs an entry on bikesheds Message-ID: <200007181920.MAA04706@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/20009; it has been noted by GNATS. From: Brooks Davis <brooks@one-eyed-alien.net> To: Ben Smithurst <ben@FreeBSD.org> Cc: brooks@one-eyed-alien.net, FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/20009: [PATCH] the FAQ needs an entry on bikesheds Date: Tue, 18 Jul 2000 12:18:49 -0700 On Tue, Jul 18, 2000 at 07:17:30PM +0100, Ben Smithurst wrote: > brooks@one-eyed-alien.net wrote: > > > People are confused by all the refrences on hackers, etc. to the color > > of bikesheds. There should be a FAQ about this. > > I'm starting to think we'll need a "FreeBSD Jargon" section of the FAQ > soon. We'd only really have four things to put it in for now though > (MFC, repo-copy, bike shed, fairings) so I don't think it's worth it > yet. OTOH, the kernel config part only has four questions, so perhaps > we could. That might not be a bad idea. The question in my mind is where do glossary entries stop (MFC and repo-copy seem to me to be those) and where do FAQ entries begin (bikeshed and fairings have significant context in their defination). > > + <para>"What is it about this bike shed ?" Some of you have > > I'd use “...” instead of "..." > > [I think that's right, it's either &[lr]dquo; or <quote>, not ".." > anyway. I think the last agreement was &[lr]dquo;.] I'm almost certain it was decided to do it the other way so quote characters would be automagicaly matched and localized properly. The problem was that quote styles aren't even consistant withing the same language. For instance, I've got at least one book published in the UK that uses quotes that look kinda like >>foo bar baz<< (except there are specific quote characters. > > + paying attention, that he is *here*.</para> > > Perhaps <emphasis>foo</emphasis> instead of *foo*, or something. The > FAQ isn't limited to ASCII text like email is. :-) I though of doing that, but it's quoted text. We could do that, but I'd want to be sure that the * (or similar) emphasis marks where being added in the text version. I don't know what w3m does. > Other than that, this should probably go in the FAQ soon. I'll fix > those minor things and maybe commit it soonish. Thinking about it some more, I think I'd also strike the <title> text from the blockquote. It's redundent and the rendering in HTML looks kinda stupid IMHO. -- Brooks -- Any statement of the form "X is the one, true Y" is FALSE. 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?200007181920.MAA04706>