From owner-freebsd-doc Wed Mar 25 20:57:41 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id UAA13487 for freebsd-doc-outgoing; Wed, 25 Mar 1998 20:57:41 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from ppp1712.on.bellglobal.com (ppp1712.on.bellglobal.com [206.172.249.176]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id UAA13480 for ; Wed, 25 Mar 1998 20:57:38 -0800 (PST) (envelope-from ac199@hwcn.org) Received: from localhost (tim@localhost) by ppp1712.on.bellglobal.com (8.8.8/8.8.8) with SMTP id XAA00500; Wed, 25 Mar 1998 23:55:59 -0500 (EST) (envelope-from ac199@hwcn.org) X-Authentication-Warning: ppp1712.on.bellglobal.com: tim owned process doing -bs Date: Wed, 25 Mar 1998 23:55:58 -0500 (EST) From: Tim Vanderhoek X-Sender: tim@localhost Reply-To: ac199@hwcn.org To: Sean Kelly cc: nik@iii.co.uk, doc@FreeBSD.ORG Subject: Re: [REVIEW] Changes to the DocProj web pages In-Reply-To: <35192AB1.43F399D@plutotech.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, 25 Mar 1998, Sean Kelly wrote: > These new pages feel professional yet inviting. I like them. Yes. > The only nits I have to pick are comprised of punctuation errors and > typos: On the `docproj' page, the second paragraph uses "it's" when it > should be "its". (The paragraph after that one gets it right.) Yes, and other things such as a farely interesting spelling of fairly. "have got commit privs" should probably be just "have commit privs", and "Others haven't got ...": "Others don't have", etc. I'm sure it's possible to find lots of those such things... :-) 1) Are we going to start using contractions again? In a similar vein, does "folks" translate well? It sounds fine to me, but it could be a bit dialect-specific, maybe? 2) It would probably be nicer if the section on submitting info to the doc. proj. were merged with the general section on submitting things, already in the handbook. 3) Obviously doc-set should say a couple things about the actual purpose of the Faq and Handbook beyond just "they are maintained". :) 4) So long as someone's willing to talk style, may I submit that series such as "apple, job, and day" use a comma before the "and". This is probably not what many of the outmoded old-timers were taught back in the day, but it's like totally way sexier. 5) You sound a little optimistic about finding people willing to mark-up submitted plain-text documents. Would you like me to point you to an aging PR submitting just such a plain-text document? [On that topic, what do people think of assigning doc-related PRs to the freebsd-doc list (similar to what's done for the freebsd-ports list)? It seems that this is perhaps part of the solution to our burgeoning PR list (eventually doing similar things for freebsd-fs, etc.).] -- tIM...HOEk OPTIMIZATION: the process of using many one-letter variables names hoping that the resultant code will run faster. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message