From owner-freebsd-chat@FreeBSD.ORG Fri May 30 15:41:47 2003 Return-Path: Delivered-To: freebsd-chat@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6D56337B401 for ; Fri, 30 May 2003 15:41:47 -0700 (PDT) Received: from phoenix.welearn.com.au (phoenix.welearn.com.au [139.130.44.81]) by mx1.FreeBSD.org (Postfix) with ESMTP id E06B143F75 for ; Fri, 30 May 2003 15:41:44 -0700 (PDT) (envelope-from sue@welearn.com.au) Received: from phoenix.welearn.com.au (localhost [127.0.0.1]) h4UMfcgC089859; Sat, 31 May 2003 08:41:38 +1000 (EST) (envelope-from sue@phoenix.welearn.com.au) Received: (from sue@localhost) by phoenix.welearn.com.au (8.12.8/8.12.8/Submit) id h4UMfcIC089858; Sat, 31 May 2003 08:41:38 +1000 (EST) (envelope-from sue) Date: Sat, 31 May 2003 08:41:38 +1000 From: Sue Blake To: Matthew Hunt Message-ID: <20030531084138.R33085@welearn.com.au> Mail-Followup-To: Sue Blake , Matthew Hunt , chat@freebsd.org References: <3ECD3A8C.1040506@potentialtech.com> <00ae01c32668$2ff5ad70$2441d5cc@nitanjared> <20030531072026.O33085@welearn.com.au> <20030530213625.GA41089@wopr.caltech.edu> <20030531080645.Q33085@welearn.com.au> <20030530221619.GA41668@wopr.caltech.edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20030530221619.GA41668@wopr.caltech.edu>; from mph@astro.caltech.edu on Fri, May 30, 2003 at 03:16:19PM -0700 X-PGP-Fingerprint: E9A3 7B97 C563 DBB1 979E BC04 D2A2 9DA3 1274 7885 cc: chat@freebsd.org Subject: Re: grammar X-BeenThere: freebsd-chat@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Non technical items related to the community List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 30 May 2003 22:41:47 -0000 On Fri, May 30, 2003 at 03:16:19PM -0700, Matthew Hunt wrote: > On Sat, May 31, 2003 at 08:06:45AM +1000, Sue Blake wrote: > > > Tell me, how would you follow the following (hypothetical) instruction? > > > > In case you run out of memory, don't run all of the programs together. > > > > Is it something to do as a precaution, or a response to take when > > an unlikely situation occurs? I would read it as a precaution and > > make a workplace rule that we must follow it. > > I suppose I would read it the same way, although the sentence strikes > me as odd for some reason. I can't remember ever coming across a written > instruction in the "In case X do Y" format, and evidently there's a good > reason people don't write that way. I think it's because of the "In case" > being at the start of the sentence instead of the end, but I can't put my > finger on it. > > Do you know the national origin of this documentation? Was it generally > satisfactory otherwise? I'm wondering if it was written by a non-native > speaker. I'm not sure. His English is otherwise excellent, but it could be his second language, and I'd rather not reveal his identity. Many people in the USA have used this documentation without problems, so it's likely that their language can accept his meaning whereas ours cannot. It is also possible that most people who read the documentation are hacker types who know what it will say before they read it so they don't dwell on the exact meaning of words. FWIW I have seen ambiguous use of "in case" occasionally in our man pages, and quite often in documents written by people whose first language is German. When I read the man pages, because I already have a good understanding, I can guess what to do. If I were floundering then it would be difficult to understand, or confident misinterpretation would easy. Over time I have learned to grit my teeth and guess the intended meaning without complaint, but sometimes my guess has been wrong. I started blaming myself, until the mutiny at work. The correctness or otherwise, and national differences, is something we should sort out for its own sake. However, in the particular case of the use of the documentation I mentioned, we have a clear demonstration of its failure to communicate with even IT-smart users. After all, that is the purpose of documentation. I had a room full of staff politely protesting in unison that it said unambiguously that you must take this precaution. When it comes to documentation, anything that fails to communicate the correct user action is wrong, and nothing else can override that if you want the system to work. -- Regards, -*Sue*-