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
_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"

Reply via email to