immuni-documentation icon indicating copy to clipboard operation
immuni-documentation copied to clipboard

Typo: information is a collective noun

Open ioggstream opened this issue 5 years ago • 2 comments

Nitpick

Here and everywhere: information is a collective noun, so you don't expect to use it with plural (eg. infos).

https://github.com/immuni-app/documentation/blob/e09ec5b327f55d0543f4235f44ffb606a0b0a52f/API.yaml#L209

Note

Fix it after merging #33 and #34

ioggstream avatar May 16 '20 12:05 ioggstream

Hi Roberto,

Thanks for raising this point. I actually answered it in #26, so please excuse the C+P!

Christy

--

The Info versus Infos debate is one that we had internally during the drafting process. You are absolutely correct to note that Information is an uncountable noun. However, in this case, it can be helpful to think of Info not as an abbreviation of Information, per se, but as the name of a certain type of defined unit (Exposure Info, Technical Info, etc.). There can be—indeed, there are—more than one of these units. As such, these defined units’ names would become Exposure Infos and Technical Infos.

Please know that, as a native English speaker, Infos isn’t particularly pleasing to my ears either! I recognise why you would raise this flag, and I appreciate that you have done so. However, having debated it within the company on several occasions, we are happy with our decision to retain the original in this case.

Thanks again for your input.

Christy Lead Copywriter

ckeenan151 avatar May 16 '20 19:05 ckeenan151

Hi Christy and thanks for your reply.

As it seems that the rationale of your decision can be relevant to the project and has semantic impacts on the API fields. If that's not already documented, I strongly suggest to find a suitable place in the documentation: if you decide to do so you could reference this issue, otherwise just let me know and I'll close it.

ioggstream avatar May 16 '20 22:05 ioggstream