Hacker News new | ask | show | jobs
by redcap 917 days ago
The guide has a section on accuracy but doesn’t talk about having punctuation outside of quotation marks. There’s a world of difference between

1. Please enter the text “foo bar.”

and

2. Please enter the text “foo bar”.

The first is normal American practice, but suggests incorrectly that the period (.) should be input.

Technical writing should be accurate - meaning all quotes should be a true representation that is not subject to style whimsy.

2 comments

As an American, I never knew #1 was American practice and have only ever used option #2 my entire career. #1 makes no sense.
I switched to the British practice (punctuation outside quotes) years ago, and no one has ever complained. I have vague hopes that in another couple of hundred years we'll have solved that problem.

Imperial vs metric, however, will never go away.