From owner-freebsd-doc Wed Oct 6 8:23: 1 1999 Delivered-To: freebsd-doc@freebsd.org Received: from server.baldwin.cx (jobaldwi.campus.vt.edu [198.82.67.146]) by hub.freebsd.org (Postfix) with ESMTP id 7AA1C153B8 for ; Wed, 6 Oct 1999 08:22:46 -0700 (PDT) (envelope-from jobaldwi@vt.edu) Received: from john.baldwin.cx (john [10.0.0.2]) by server.baldwin.cx (8.9.3/8.9.3) with ESMTP id LAA00619; Wed, 6 Oct 1999 11:22:33 -0400 (EDT) (envelope-from jobaldwi@vt.edu) Message-Id: <199910061522.LAA00619@server.baldwin.cx> X-Mailer: XFMail 1.3.1 [p0] on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: Date: Wed, 06 Oct 1999 11:22:33 -0400 (EDT) From: John Baldwin To: Narvi Subject: Re: Style Challenge! Cc: FreeBSD Documentation Project Cc: FreeBSD Documentation Project , Neil Blakey-Milner Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 06-Oct-99 Narvi wrote: > > On Wed, 6 Oct 1999, Neil Blakey-Milner wrote: > >> Hi, >> >> . Two spaces after '.' >> > No!!!! I can't see why you should even think about this. That's how formal English specifies sentence endings and is how the rest of the documentation is. >> . Always close inline tags on the same line as its contents - ie, >> never: >> >> foo foo blah blah blah >> >> > > What if they are multiline? What if the other enclosing tags that end > before the don't fit on a single line? foo bar balh fadaf afds fdef afdafd That's what he means. >> Any comments? >> >> (oh, and does it matter about combining whitespace/markup/content >> changes in the articles at this point, without any translations?) >> > The translator will really hate any pure formatting style changes. Yes, but there aren't currently any translated versions so this doesn't apply. :) Still, it's best to go ahead and make it a habit and always follow it for all -doc commits, IMO. --- John Baldwin -- http://www.cslab.vt.edu/~jobaldwi/ PGP Key: http://www.cslab.vt.edu/~jobaldwi/pgpkey.asc "Power Users Use the Power to Serve!" - http://www.FreeBSD.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message