Skip to content
This repository has been archived by the owner on Jun 14, 2024. It is now read-only.

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

Open
DmitriGit opened this issue Apr 20, 2021 · 0 comments

Comments

@DmitriGit
Copy link
Contributor

DmitriGit commented Apr 20, 2021

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?

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant