[Date Prev][Date Next][Thread Prev][Thread Next]
- Subject: Re: Installing Lua on macOS in order to update Lua.
- From: Glenn Travis <travplays@...>
- Date: Sat, 24 Feb 2018 02:31:43 -0600
> On Feb 23, 2018, at 9:36 PM, Dirk Laurie <email@example.com> wrote:
> 2018-02-24 2:08 GMT+02:00 Glenn Travis <firstname.lastname@example.org>:
>> RE: readme.html
>> I consider this to be technical writing and as such passive voice, may or should is absolutely wrong.
Perhaps it is due to a rather mindset that was developed as the supervisor of an operations technical writers group in a nuclear power plant back in the 80s.
> It is hard to argue with someone that uses phrases like "absolutely wrong".
>> Further, all that I am asking for is the addition of a few words to Mac users. It is not a policy, they are instructions in which at times “must" is a requirement if one desires the user/reader to have success.
Seeing as how I don’t know Windows very well, perhaps make or make install as written in the readme.html page is all that is needed. I think that non-mac users can struggle with a five or six word heads up edit.
> Not even Windows gets separate treatment in readme.html.
> Why not have a go at a separate readme-osx.html? Mac users may^H^H^H
> must read it but others know they do not need to?
> On the other hand, even that may^H^H^H will be inadequate. Mac users
> are not in the habit of reading instructions. They are accustomed to
> things that Just Work. ("If you have a Mac oven, insert the dinner and
> press start. The oven will set itself and cook the dinner.")