From owner-freebsd-doc Thu Jul 19 23: 4:26 2001 Delivered-To: freebsd-doc@freebsd.org Received: from bazooka.unixfreak.org (bazooka.unixfreak.org [63.198.170.138]) by hub.freebsd.org (Postfix) with ESMTP id 3446D37B405 for ; Thu, 19 Jul 2001 23:04:24 -0700 (PDT) (envelope-from dima@unixfreak.org) Received: from hornet.unixfreak.org (hornet [63.198.170.140]) by bazooka.unixfreak.org (Postfix) with ESMTP id DA9673E2F; Thu, 19 Jul 2001 23:04:23 -0700 (PDT) To: Murray Stokely Cc: doc@FreeBSD.ORG Subject: Re: Markup for ports In-Reply-To: <20010719120925.G27537@meow.osd.bsdi.com>; from murray.stokely@windriver.com on "Thu, 19 Jul 2001 12:09:25 -0700" Date: Thu, 19 Jul 2001 23:04:23 -0700 From: Dima Dorfman Message-Id: <20010720060423.DA9673E2F@bazooka.unixfreak.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Murray Stokely writes: > I support this in general, but more thought needs to be placed on > how this will look without the benefit of a hyperlink. Another > example of dependence on hyperlinks is the use of being > printed out as file:/// in the printed version of the Handbook which > doesn't look very good. It seems that many sentences are constructed > in the handbook such that they depend on the hyperlink for proper > context. I don't want anything to encourage that practice. > > "Other interfaces, like databases/tkgnats should also work nicely." > > This is pretty informal. Will the markup given to your new > tag be sufficient to clue in new users that we are talking about a > FreeBSD port? Or is more verbiage necessary, such as : > > "Other interfaces, like the port databases/tkgnats should also work > nicely." Okay, but this is up to the author of that sentence. is akin to ; just like the latter can be abused, so can the former. The hyperlink is just an extra bonus; the real point is to have more precise markup. If you think the hyperlink will encourage dependence on it, I'm fine with being another name for . To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message