Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 06 Oct 1999 11:22:33 -0400 (EDT)
From:      John Baldwin <jobaldwi@vt.edu>
To:        Narvi <narvi@haldjas.folklore.ee>
Cc:        FreeBSD Documentation Project <doc@FreeBSD.ORG>, Neil Blakey-Milner <nbm@mithrandr.moria.org>
Subject:   Re: Style Challenge!
Message-ID:  <199910061522.LAA00619@server.baldwin.cx>
In-Reply-To: <Pine.BSF.3.96.991006163638.37031G-100000@haldjas.folklore.ee>

next in thread | previous in thread | raw e-mail | index | archive | help

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:
>> 
>> <para>foo foo blah blah blah
>>   </para>
>> 
> 
> What if they are multiline? What if the other enclosing tags that end
> before the </para> don't fit on a single line?

<para>foo bar balh
  fadaf afds fdef
  afdafd</para>

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 <jobaldwi@vt.edu> -- 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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199910061522.LAA00619>