B.Goode wrote: ↑
Wed Mar 25, 2020 3:15 pm
The first line of the documentation said: "Your hard disk will need to be formatted before installing this software."
You can sort of see what they meant. But following it literally would have been catastrophic for most users...
You should have sent them a copy of "Eats, shoots and leaves". There's some commas missing. When I worked for IBM we had a forum for nitpicking stuff like that in IBM docs. There was a phrase used by the professional tech writers to highlight how they'd fix that stuff. "Real writers rewrite to avoid the problem", which due to IBM's penchant for TLAs, TLA/X and XLTLA* that was shortened to "RWRTATP". The nitpicking forum was a minefield as any posts on there were fair game for the nitpickers (except on 25th Sept which was "August founder's day" to celebrate Hugh Darwen's (https://en.wikipedia.org/wiki/Hugh_Darwen
"Your hard disk will need to have been formatted before ..." removes some ambiguity. "Before installing you will need a system with a pre-formatted hard disk" may be better.
*TLA ==three letter acronym, TLA/X == three letter acronym extended (4 letters) & XLTLA == extra long three letter acronym (5 letters)