All of lore.kernel.org
 help / color / mirror / Atom feed
From: "Michael Opdenacker" <michael.opdenacker@bootlin.com>
To: Richard Purdie <richard.purdie@linuxfoundation.org>,
	YP docs mailing list <docs@lists.yoctoproject.org>
Subject: Re: [docs] "metadata": plural or singular or both?
Date: Wed, 21 Jul 2021 19:04:25 +0200	[thread overview]
Message-ID: <dddfda36-0837-51a8-39ad-3b49eceb4e84@bootlin.com> (raw)
In-Reply-To: <db9ccfa4d7a7c41b6f926366918a71c76c37ce7c.camel@linuxfoundation.org>

Hi,

On 7/21/21 6:20 PM, Richard Purdie wrote:
> Hi Michael,
>
> On Wed, 2021-07-21 at 18:11 +0200, Michael Opdenacker wrote:
>> I'm currently reading BitBake's documentation, and I'm always
>> uncomfortable when I read "Metadata is", while I know that in English
>> and in Latin, "data" is the plural of "datum". However, many people seem
>> to use "data" as singular.
>>
>> I also find confusing that actually "metadata" is both used:
>>
>>   * in plural form as in: "Split metadata into layers and allow layers
>>     to enhance or override other layers."
>>   * in singular form as in: "Metadata is stored in recipe (|.bb|) and
>>     related recipe “append” (|.bbappend|) files"
>>
>> How do you feel about this? I'm especially interested in the feedback
>> from native English speakers, which I'm not.
> Personally, I'd read both of those sentences above as being correct and
> they sound fine to me as a native speaker. There are other things in the
> manual that probably grate on me a bit but not that!

Thank you for your feedback.

Here's a more troubling sentence:
"BitBake executes tasks according to provided metadata that builds up
the tasks"

Here, "metadata" is obviously plural because otherwise you would say "a
provided metadata", but it still conjugated as if it was singular.
Doesn't this sentence grate a bit?

Cheers,

Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com


  reply	other threads:[~2021-07-21 17:04 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-07-21 16:11 Michael Opdenacker
2021-07-21 16:20 ` [docs] " Richard Purdie
2021-07-21 17:04   ` Michael Opdenacker [this message]
2021-07-22  6:40     ` Richard Purdie
2021-07-29 13:01       ` [PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata" Michael Opdenacker
2021-07-29 13:05         ` [bitbake-devel] " Quentin Schulz
2021-07-29 13:09           ` [docs] " Michael Opdenacker
2021-07-29 21:31           ` Richard Purdie
2021-07-30 10:29             ` [PATCH v4] " Michael Opdenacker
2021-07-30 10:33             ` [docs] [bitbake-devel] [PATCH] " Michael Opdenacker

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=dddfda36-0837-51a8-39ad-3b49eceb4e84@bootlin.com \
    --to=michael.opdenacker@bootlin.com \
    --cc=docs@lists.yoctoproject.org \
    --cc=richard.purdie@linuxfoundation.org \
    --subject='Re: [docs] "metadata": plural or singular or both?' \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.