Re: [jakartaee-platform-dev] Platform and WebProfile specs ready to be "

["Kevin Sutter" <sutter@xxxxxxxxxx>]

I should point out
that the chapter files for the Platform and WebProfile are in the following
corresponding directories...

https://github.com/eclipse-ee4j/jakartaee-platform/tree/master/specification/src/main/asciidoc/platform
https://github.com/eclipse-ee4j/jakartaee-platform/tree/master/specification/src/main/asciidoc/webprofile

No other files
need to be modified for this requested exercise.

You can either
do a "mvn clean install" and look at the generated pdf or html.
 Or, you can view the corresponding sections via these urls:

https://github.com/eclipse-ee4j/jakartaee-platform/blob/master/specification/src/main/asciidoc/platform/Platform.adoc
https://github.com/eclipse-ee4j/jakartaee-platform/blob/master/specification/src/main/asciidoc/webprofile/WebProfile.adoc

Have fun!

---------------------------------------------------
Kevin Sutter 
STSM, MicroProfile and Jakarta EE architect
e-mail:  sutter@xxxxxxxxxx     Twitter:  @kwsutter
phone: tl-553-3620 (office), 507-253-3620 (office)    
LinkedIn: https://www.linkedin.com/in/kevinwsutter



From:
       "Kevin
Sutter" <sutter@xxxxxxxxxx>
To:
       "jakartaee-platform
developer discussions" <jakartaee-platform-dev@xxxxxxxxxxx>
Date:
       07/03/2019
10:19 PM
Subject:
       [EXTERNAL]
[jakartaee-platform-dev] Platform and WebProfile specs ready to be  
     "jakarta-ized"
Sent
by:        jakartaee-platform-dev-bounces@xxxxxxxxxxx

---

Hi,
Most of you know that the Java EE Platform and WebProfile specs have now
been contributed to Eclipse and ready to go through the transformation
to Jakarta Platform and WebProfile specs:
https://github.com/eclipse-ee4j/jakartaee-platform/tree/master/specification

I have broken up the individual specs into slightly more manageable pieces
of asciidoc (each spec used to be one giant asciidoc file).  I broke
them up by chapters.  Of course, some are larger than others, but
at least we can now divide and conquer the effort in front of us.  Many
of you have been asking "how can I help?".  Now's your chance.
 If you are interested and available, we would appreciate PRs with
cleaning up the various sections of these two spec documents.

The cleanup required is mostly tedious work.

• The main thing is changing "Java EE" to "Jakarta EE".  
• Modifying references to the JCP with corresponding Eclipse processes.
• References to existing Java EE technologies, acronyms, and JSRs are okay as long as they are properly attributed.
• Be careful not to modify the semantics or behavior -- we need Jakarta EE 8 to be functionally equivalent to Java EE 8.

We
are looking for the minimal work required.  At this point, do not
further subdivide the asciidoc files.  I would suggest keeping the
PRs short and simple.  Don't try to do "everything" in one
PR.  You don't even have to complete a whole chapter in a single PR.
 Maybe identify the subsections covered in the title of your PR.  Shorter
PRs will be easier for the committers to evaluate and merge into master.
 Reference the list of existing PRs before starting on a chapter to
avoid duplication of effort.

I am sending out this request now since many of us in the US will be out
for the extended weekend.  There are a few committers in other parts
of the world, so hopefully we'll make some progress over the weekend.  I
didn't want to wait until Monday to start this effort since we need to
have these spec docs ready by July 15.

Thanks for your help!

---------------------------------------------------
Kevin Sutter 
STSM, MicroProfile and Jakarta EE architect
e-mail:  sutter@xxxxxxxxxx     Twitter:  @kwsutter
phone: tl-553-3620 (office), 507-253-3620 (office)    
LinkedIn: https://www.linkedin.com/in/kevinwsutter_______________________________________________
jakartaee-platform-dev mailing list
jakartaee-platform-dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe
from this list, visit
https://www.eclipse.org/mailman/listinfo/jakartaee-platform-dev