Skip to contentSkip to conversation

"metadata": plural or singular or both?

PATCH Superseded Michael Opdenacker 3 participants 10 messages Jul 21, 2021 – Jul 30, 2021

lore
Share & tools
lore
#0 lore raw

Greetings,

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.

Thank you in advance,

Michael.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com
#1 lore raw

Hi Michael,

Quoted 7 lines · Michael Opdenacker

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:

Quoted 7 lines

  * 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!

Cheers,

Richard

#2 lore raw

Hi,

Quoted 15 lines · Richard Purdie

Hi Michael,

Quoted 12 lines · Michael Opdenacker

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"

Quoted 5 lines
Quoted 2 lines

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.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com
#3 lore raw
Quoted 26 lines · Michael Opdenacker

Hi,

Quoted 15 lines · Richard Purdie

Hi Michael,

Quoted 12 lines · Michael Opdenacker

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"

Quoted 5 lines
Quoted 2 lines

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.

Quoted 7 lines

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?

That one doesn't sound right. You could say it is missing a "the", as in "according to the provided metadata that builds up" but I don't really like the phrasing there even with that fix, the "that" sounds wrong.

Cheers,

Richard

#4 lore raw

PATCH 1/1 doc: bitbake-user-manual: grammar fix for the number of "metadata"

"metadata" is used both as singular and as plural.
The first change fixes a case in which the verbs have a singular conjugation but articles that indicate a plural case.

The second change is for consistency with the first one inside the same paragraph.

---
 doc/bitbake-user-manual/bitbake-user-manual-intro.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
doc/bitbake-user-manual/bitbake-user-manual-intro.rst +2 -2
index eb140665..64e7305d 100644
@@ -27,11 +27,11 @@ Linux software stacks using a task-oriented approach.
 Conceptually, BitBake is similar to GNU Make in some regards but has
 significant differences:
 
--  BitBake executes tasks according to provided metadata that builds up
+-  BitBake executes tasks according to provided metadata that build up
    the tasks. Metadata is stored in recipe (``.bb``) and related recipe
    "append" (``.bbappend``) files, configuration (``.conf``) and
    underlying include (``.inc``) files, and in class (``.bbclass``)
-   files. The metadata provides BitBake with instructions on what tasks
+   files. The metadata provide BitBake with instructions on what tasks
    to run and the dependencies between those tasks.
 
 -  BitBake includes a fetcher library for obtaining source code from
Signature · 1 line
2.25.1
#5 lore raw

Re: [bitbake-devel] [PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

Hi Michael,

Quoted 17 lines · Michael Opdenacker

"metadata" is used both as singular and as plural.
The first change fixes a case in which the verbs have a singular conjugation but articles that indicate a plural case.

The second change is for consistency with the first one inside the same paragraph.

---
 doc/bitbake-user-manual/bitbake-user-manual-intro.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
doc/bitbake-user-manual/bitbake-user-manual-intro.rst +0 -0
index eb140665..64e7305d 100644

doc/bitbake-user-manual/bitbake-user-manual-intro.rst Linux software stacks using a task-oriented approach. · line 31

Quoted 6 lines
doc/bitbake-user-manual/bitbake-user-manual-intro.rst +1 -1
@@ -27,11 +27,11 @@ Linux software stacks using a task-oriented approach.
 Conceptually, BitBake is similar to GNU Make in some regards but has
 significant differences:
 
--  BitBake executes tasks according to provided metadata that builds up
+-  BitBake executes tasks according to provided metadata that build up
    the tasks. Metadata is stored in recipe (``.bb``) and related recipe

Then "Metadata are" here seems appropriate to me. What do you think?

Cheers,
Quentin

#6 lore raw

Re: [docs] [bitbake-devel] [PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

Hi Quentin,

Quoted 23 lines · Quentin Schulz

Hi Michael,

Quoted 20 lines · Michael Opdenacker

"metadata" is used both as singular and as plural.
The first change fixes a case in which the verbs have a singular conjugation but articles that indicate a plural case.

The second change is for consistency with the first one inside the same paragraph.

---
 doc/bitbake-user-manual/bitbake-user-manual-intro.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
doc/bitbake-user-manual/bitbake-user-manual-intro.rst +0 -0
index eb140665..64e7305d 100644
@@ -27,11 +27,11 @@ Linux software stacks using a task-oriented approach.
 Conceptually, BitBake is similar to GNU Make in some regards but has
 significant differences:
 
Quoted 4 lines

doc/bitbake-user-manual/bitbake-user-manual-intro.rst Linux software stacks using a task-oriented approach. · line 31

Quoted 3 lines
doc/bitbake-user-manual/bitbake-user-manual-intro.rst +1 -1
--  BitBake executes tasks according to provided metadata that builds up
+-  BitBake executes tasks according to provided metadata that build up
    the tasks. Metadata is stored in recipe (``.bb``) and related recipe

Then "Metadata are" here seems appropriate to me. What do you think?

Good catch, many thanks! I paid attention to the following case, but missed that one.
Cheers,
Michael.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com
#7 lore raw

Re: [bitbake-devel] [PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

In reply to Quentin Schulz
Quoted 26 lines · Quentin Schulz

Hi Michael,

Quoted 23 lines · Michael Opdenacker

"metadata" is used both as singular and as plural.
The first change fixes a case in which the verbs have a singular conjugation but articles that indicate a plural case.

The second change is for consistency with the first one inside the same paragraph.

---
 doc/bitbake-user-manual/bitbake-user-manual-intro.rst | 4 ++--

 1 file changed, 2 insertions(+), 2 deletions(-)
doc/bitbake-user-manual/bitbake-user-manual-intro.rst +0 -0
index eb140665..64e7305d 100644
@@ -27,11 +27,11 @@ Linux software stacks using a task-oriented approach.

 Conceptually, BitBake is similar to GNU Make in some regards but has significant differences:

Quoted 5 lines
Quoted 3 lines

-- BitBake executes tasks according to provided metadata that builds up +- BitBake executes tasks according to provided metadata that build up the tasks. Metadata is stored in recipe (``.bb``) and related recipe

Then "Metadata are" here seems appropriate to me. What do you think?

I'd have said "Metadata is stored in recipes"...

Cheers,

Richard

#8 lore raw

PATCH v4 1/1 doc: bitbake-user-manual: grammar fix for the number of "metadata"

"metadata" is used both as singular and as plural.
This fixes a case in which the verb has a singular conjugation, which conflicts with the absence of article indicating a plural case.

---
 doc/bitbake-user-manual/bitbake-user-manual-intro.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
doc/bitbake-user-manual/bitbake-user-manual-intro.rst +1 -1
index eb140665..ec66d8c2 100644
@@ -27,7 +27,7 @@ Linux software stacks using a task-oriented approach.
 Conceptually, BitBake is similar to GNU Make in some regards but has
 significant differences:
 
--  BitBake executes tasks according to provided metadata that builds up
+-  BitBake executes tasks according to the provided metadata that builds up
    the tasks. Metadata is stored in recipe (``.bb``) and related recipe
    "append" (``.bbappend``) files, configuration (``.conf``) and
    underlying include (``.inc``) files, and in class (``.bbclass``)
Signature · 1 line
2.25.1
#9 lore raw

Re: [docs] [bitbake-devel] [PATCH] doc: bitbake-user-manual: grammar fix for the number of "metadata"

In reply to Richard Purdie
Quoted 1 line · Richard Purdie

I'd have said "Metadata is stored in recipes"...

Let's trust you on this, Richard.
All this back and forth just for eventually adding a single "the"!

At least, I'm starting to understand the usage of "metadata" and "data" in today's English.
Thanks for your time and patience!
Michael.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com