jakartaee / jakartaee/platform
Improving "Introduction" content.
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 230
- Forks
- 77
- Avg merge
- 8d 5h
- Merged PRs (30d)
- 1
Description
Hello Team,
this issue obviously has very low priority and may be I'm wrong, but I open it anyway, with the only desire to make "Jakarta EE Platform Specification" better. If I'm wrong - sorry for wasting your time...
So... If you read the first phrase of "Introduction":
"_Enterprises today need to **extend** their **reach**, **reduce** their **costs**, and lower the response times of their **services** to customers, employees, and suppliers_."
It seems, in my opinion, that here:
- "**extends reach**" and "**reduce costs**" of enterprises does **not** depend on "**services**",
- and that for enterprises, all that is related to **services**, is ONLY "lower the response times to customers, employees, and suppliers".
So it seems that "Jakarta EE" (that, theoretically, help to develop applications that provide those **services**) is only for "lower the response times to customers, employees, and suppliers" and not for "**extends reach**" and "**reduce costs**".
If you read the second phrase, however:
"_Typically, applications that provide these **services** must combine existing enterprise information systems (EISs) with new business functions that deliver services to a broad range of users._"
now we have "**services** to a broad range of users" so here we say about **services** that "**extend reach**".
And below in the "Introduction":
"_The Jakarta™ EE Platform reduces the cost and complexity of developing multitier, enterprise **services**._"
so here we have "**reduce the cost**".
I repeat, maybe I'm wrong, but what do you think about the following version of the first phrase:
"Enterprises today need the **services that extend their reach, reduce their costs, and lower the response times** to customers, employees, and suppliers."
Thank you very much for patience!
Have a nice day,
Dmitri.
[AB#71](https://dev.azure.com/jakarta-ee-azdo/7cf9a9d3-9854-41e0-9a66-99506a9ed874/_workitems/edit/71)
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Search the Jakarta EE Platform Specification sources for the quoted first sentence in the Introduction. Compare the proposed wording with the surrounding Introduction text, then update the sentence if it improves the meaning and verify that the specification documentation remains coherent.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 45/100