eclipse-ee4j / jakartaee-tutorial

Jakarta EE Tutorial
https://eclipse-ee4j.github.io/jakartaee-tutorial
Eclipse Public License 2.0
96 stars 69 forks source link

Ambiguous using of word "resource" in the paragraph "3.1. Resource Creation". #247

Open DmitriGit opened 3 years ago

DmitriGit commented 3 years ago

In the first sentence of this paragraph the term "resource" is "a program object" that provides connection to the "systems": "A resource is a program object that provides connections to such systems as database servers and messaging systems."

In the rest of paragraph, however, the word "resource" reference "systems" (i.e begins to be "system"): "Jakarta EE components can access a wide variety of resources, including databases, mail sessions, Jakarta Messaging objects, and URLs."

So, I think this creates a little confusion, because: "resource" provides connection to "system" and then is used instead of the word "system".

My proposal is to leave the first sentence as it is, but then use the word "system" or the first sentence write word "resource" with a first capital letter as: "Resource".

Does this make sence to you?