Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 14 Aug 2014 11:43:29 -0400 (EDT)
From:      Benjamin Kaduk <kaduk@MIT.EDU>
To:        Warren Block <wblock@wonkity.com>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: /etc/motd update
Message-ID:  <alpine.GSO.1.10.1408141138460.21571@multics.mit.edu>
In-Reply-To: <alpine.BSF.2.11.1408131411390.3442@wonkity.com>
References:  <alpine.BSF.2.11.1408131411390.3442@wonkity.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 13 Aug 2014, Warren Block wrote:

> The existing /etc/motd breaks many of our document rules and has some weird
> language constructs.  The current version in HEAD:
> http://svnweb.freebsd.org/base/head/etc/motd?view=co
>
> Here is a rewrite.  URLs are now the only thing on a line, instead of inline
> and hard to locate.  No contractions are used.  Odd phrases are rephrased:
>
> Here is the proposed new version and a diff:
> http://www.wonkity.com/~wblock/motd/motd
> http://www.wonkity.com/~wblock/motd/motd.diff

I think that "Before seeking technical support, please use these
resources" remains an awkward phrase.  The intent is to have the user
attempt to help themself before resorting to flailing and asking for help
on the internet, but not all of the listed resources are relevant for any
particular situation, and in some sense they *are* providing technical
support.

We may just want to note that "The following resources are available to
learn about the system", or something of a similar phrasing.

The other changes seem okay.

-Ben



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