Preferred generic form





.everyoneloves__top-leaderboard:empty,.everyoneloves__mid-leaderboard:empty{ margin-bottom:0;
}






up vote
0
down vote

favorite












We're writing documentation of our e-commerce software (that enables people to open their own online stores) in which tags are used to print different contents in customers' online stores. I'm wondering what's the best way to refer to such contents, e.g.:




  1. Prints the content of a newsletter.

  2. Prints the newsletter content.

  3. Prints a newsletter's content.


If you search in Google, the 2nd option is the most popular one. I'm tentatively in favour of the 1st option though, since the word "newsletter" should refer to any newsletter of any online store. But then I'm wondering, is there in fact any difference between the 3 sentences at all? If you wanted to refer to a specific newsletter's content, you'd have to say "the newsletter's content", isn't it so? And if there are some differences between the 3 sentences, what are they?



There are many similar cases like this. Is it ok to say e.g.



Prints...




  1. the order subtotal. (meaning the subtotal of any order placed in any store that uses the specific software)

  2. the order discount. (meaning a discount applied to any order placed in any store that uses the specific software)

  3. the payment transaction date. (meaning a payment transaction made for an order placed in a store that uses the specific software)


I'm telling myself that "the" is correct in these case, since you could convert the phrases into "of" phrases (e.g. "the discount of an order) but is this a valid test? What about other phrases, e.g. with "for":



Prints a checksum for a due payment.



Or should it be "Prints the checksum for a due payment"?



As for context: all these sentences appear at the beginnings of separate help articles that belong to our documentation, so there is actually no context provided in the articles themselves but on the other hand our readers know that the documentation refers to online stores using a specific software.










share|improve this question







New contributor




Hopohopo is a new contributor to this site. Take care in asking for clarification, commenting, and answering.
Check out our Code of Conduct.




















  • Yes. Just be consistent throughout.
    – Kris
    Nov 16 at 10:04










  • Do you mean "Yes, 1, 2 & 3 mean the same?"
    – Hopohopo
    Nov 16 at 12:49

















up vote
0
down vote

favorite












We're writing documentation of our e-commerce software (that enables people to open their own online stores) in which tags are used to print different contents in customers' online stores. I'm wondering what's the best way to refer to such contents, e.g.:




  1. Prints the content of a newsletter.

  2. Prints the newsletter content.

  3. Prints a newsletter's content.


If you search in Google, the 2nd option is the most popular one. I'm tentatively in favour of the 1st option though, since the word "newsletter" should refer to any newsletter of any online store. But then I'm wondering, is there in fact any difference between the 3 sentences at all? If you wanted to refer to a specific newsletter's content, you'd have to say "the newsletter's content", isn't it so? And if there are some differences between the 3 sentences, what are they?



There are many similar cases like this. Is it ok to say e.g.



Prints...




  1. the order subtotal. (meaning the subtotal of any order placed in any store that uses the specific software)

  2. the order discount. (meaning a discount applied to any order placed in any store that uses the specific software)

  3. the payment transaction date. (meaning a payment transaction made for an order placed in a store that uses the specific software)


I'm telling myself that "the" is correct in these case, since you could convert the phrases into "of" phrases (e.g. "the discount of an order) but is this a valid test? What about other phrases, e.g. with "for":



Prints a checksum for a due payment.



Or should it be "Prints the checksum for a due payment"?



As for context: all these sentences appear at the beginnings of separate help articles that belong to our documentation, so there is actually no context provided in the articles themselves but on the other hand our readers know that the documentation refers to online stores using a specific software.










share|improve this question







New contributor




Hopohopo is a new contributor to this site. Take care in asking for clarification, commenting, and answering.
Check out our Code of Conduct.




















  • Yes. Just be consistent throughout.
    – Kris
    Nov 16 at 10:04










  • Do you mean "Yes, 1, 2 & 3 mean the same?"
    – Hopohopo
    Nov 16 at 12:49













up vote
0
down vote

favorite









up vote
0
down vote

favorite











We're writing documentation of our e-commerce software (that enables people to open their own online stores) in which tags are used to print different contents in customers' online stores. I'm wondering what's the best way to refer to such contents, e.g.:




  1. Prints the content of a newsletter.

  2. Prints the newsletter content.

  3. Prints a newsletter's content.


If you search in Google, the 2nd option is the most popular one. I'm tentatively in favour of the 1st option though, since the word "newsletter" should refer to any newsletter of any online store. But then I'm wondering, is there in fact any difference between the 3 sentences at all? If you wanted to refer to a specific newsletter's content, you'd have to say "the newsletter's content", isn't it so? And if there are some differences between the 3 sentences, what are they?



There are many similar cases like this. Is it ok to say e.g.



Prints...




  1. the order subtotal. (meaning the subtotal of any order placed in any store that uses the specific software)

  2. the order discount. (meaning a discount applied to any order placed in any store that uses the specific software)

  3. the payment transaction date. (meaning a payment transaction made for an order placed in a store that uses the specific software)


I'm telling myself that "the" is correct in these case, since you could convert the phrases into "of" phrases (e.g. "the discount of an order) but is this a valid test? What about other phrases, e.g. with "for":



Prints a checksum for a due payment.



Or should it be "Prints the checksum for a due payment"?



As for context: all these sentences appear at the beginnings of separate help articles that belong to our documentation, so there is actually no context provided in the articles themselves but on the other hand our readers know that the documentation refers to online stores using a specific software.










share|improve this question







New contributor




Hopohopo is a new contributor to this site. Take care in asking for clarification, commenting, and answering.
Check out our Code of Conduct.











We're writing documentation of our e-commerce software (that enables people to open their own online stores) in which tags are used to print different contents in customers' online stores. I'm wondering what's the best way to refer to such contents, e.g.:




  1. Prints the content of a newsletter.

  2. Prints the newsletter content.

  3. Prints a newsletter's content.


If you search in Google, the 2nd option is the most popular one. I'm tentatively in favour of the 1st option though, since the word "newsletter" should refer to any newsletter of any online store. But then I'm wondering, is there in fact any difference between the 3 sentences at all? If you wanted to refer to a specific newsletter's content, you'd have to say "the newsletter's content", isn't it so? And if there are some differences between the 3 sentences, what are they?



There are many similar cases like this. Is it ok to say e.g.



Prints...




  1. the order subtotal. (meaning the subtotal of any order placed in any store that uses the specific software)

  2. the order discount. (meaning a discount applied to any order placed in any store that uses the specific software)

  3. the payment transaction date. (meaning a payment transaction made for an order placed in a store that uses the specific software)


I'm telling myself that "the" is correct in these case, since you could convert the phrases into "of" phrases (e.g. "the discount of an order) but is this a valid test? What about other phrases, e.g. with "for":



Prints a checksum for a due payment.



Or should it be "Prints the checksum for a due payment"?



As for context: all these sentences appear at the beginnings of separate help articles that belong to our documentation, so there is actually no context provided in the articles themselves but on the other hand our readers know that the documentation refers to online stores using a specific software.







phrases definite-articles generic






share|improve this question







New contributor




Hopohopo is a new contributor to this site. Take care in asking for clarification, commenting, and answering.
Check out our Code of Conduct.











share|improve this question







New contributor




Hopohopo is a new contributor to this site. Take care in asking for clarification, commenting, and answering.
Check out our Code of Conduct.









share|improve this question




share|improve this question






New contributor




Hopohopo is a new contributor to this site. Take care in asking for clarification, commenting, and answering.
Check out our Code of Conduct.









asked Nov 16 at 9:53









Hopohopo

61




61




New contributor




Hopohopo is a new contributor to this site. Take care in asking for clarification, commenting, and answering.
Check out our Code of Conduct.





New contributor





Hopohopo is a new contributor to this site. Take care in asking for clarification, commenting, and answering.
Check out our Code of Conduct.






Hopohopo is a new contributor to this site. Take care in asking for clarification, commenting, and answering.
Check out our Code of Conduct.












  • Yes. Just be consistent throughout.
    – Kris
    Nov 16 at 10:04










  • Do you mean "Yes, 1, 2 & 3 mean the same?"
    – Hopohopo
    Nov 16 at 12:49


















  • Yes. Just be consistent throughout.
    – Kris
    Nov 16 at 10:04










  • Do you mean "Yes, 1, 2 & 3 mean the same?"
    – Hopohopo
    Nov 16 at 12:49
















Yes. Just be consistent throughout.
– Kris
Nov 16 at 10:04




Yes. Just be consistent throughout.
– Kris
Nov 16 at 10:04












Do you mean "Yes, 1, 2 & 3 mean the same?"
– Hopohopo
Nov 16 at 12:49




Do you mean "Yes, 1, 2 & 3 mean the same?"
– Hopohopo
Nov 16 at 12:49















active

oldest

votes











Your Answer








StackExchange.ready(function() {
var channelOptions = {
tags: "".split(" "),
id: "97"
};
initTagRenderer("".split(" "), "".split(" "), channelOptions);

StackExchange.using("externalEditor", function() {
// Have to fire editor after snippets, if snippets enabled
if (StackExchange.settings.snippets.snippetsEnabled) {
StackExchange.using("snippets", function() {
createEditor();
});
}
else {
createEditor();
}
});

function createEditor() {
StackExchange.prepareEditor({
heartbeatType: 'answer',
convertImagesToLinks: false,
noModals: true,
showLowRepImageUploadWarning: true,
reputationToPostImages: null,
bindNavPrevention: true,
postfix: "",
imageUploader: {
brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
allowUrls: true
},
noCode: true, onDemand: true,
discardSelector: ".discard-answer"
,immediatelyShowMarkdownHelp:true
});


}
});






Hopohopo is a new contributor. Be nice, and check out our Code of Conduct.










 

draft saved


draft discarded


















StackExchange.ready(
function () {
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fenglish.stackexchange.com%2fquestions%2f473242%2fpreferred-generic-form%23new-answer', 'question_page');
}
);

Post as a guest















Required, but never shown






























active

oldest

votes













active

oldest

votes









active

oldest

votes






active

oldest

votes








Hopohopo is a new contributor. Be nice, and check out our Code of Conduct.










 

draft saved


draft discarded


















Hopohopo is a new contributor. Be nice, and check out our Code of Conduct.













Hopohopo is a new contributor. Be nice, and check out our Code of Conduct.












Hopohopo is a new contributor. Be nice, and check out our Code of Conduct.















 


draft saved


draft discarded














StackExchange.ready(
function () {
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fenglish.stackexchange.com%2fquestions%2f473242%2fpreferred-generic-form%23new-answer', 'question_page');
}
);

Post as a guest















Required, but never shown





















































Required, but never shown














Required, but never shown












Required, but never shown







Required, but never shown

































Required, but never shown














Required, but never shown












Required, but never shown







Required, but never shown







Popular posts from this blog

Morgemoulin

Scott Moir

Souastre