Re: [jakartaee-platform-dev] Inconsistency on the term "pruned"

["Kevin Sutter" <sutter@xxxxxxxxxx>]

jakartaee-platform-dev-bounces@xxxxxxxxxxx
wrote on 05/20/2020 12:15:25:

> From: "Steve Millidge (Payara)" <steve.millidge@xxxxxxxxxxx>
> To: jakartaee-platform developer
discussions <jakartaee-platform-
> dev@xxxxxxxxxxx>
> Date: 05/20/2020 12:15
> Subject: [EXTERNAL] Re: [jakartaee-platform-dev]
Inconsistency on 
> the term "pruned"
> Sent by: jakartaee-platform-dev-bounces@xxxxxxxxxxx
> 
> Yes we did mean removed.

Check.
 
>  
> Rereading the Jakarta EE 8 platform
spec to me that section outlines
> a 2 step process rather than defining Pruned = Optional .

Agree, it was a two step process.
 But, I quoted the final paragraph of section 6.1.3 that states pruned
== optional.

>  
> However I’m not wired to be
concerned about normative definitions 
> and things so I will leave detailed comments and conclusions to 
> those that are. It was probably me that messed up by writing pruned
> rather than removed in the release plan in the first place :)
>  
I'm not as picky either.  If
it was just up to me, I would go ahead with my planned updates and see
how the comments fall out.  But, since this type of change has such
a ripple effect, maybe even across other Specifications, I'd rather get
a general direction put in place first.

Thanks!
Kevin

> Steve
>  
> From: jakartaee-platform-dev-bounces@xxxxxxxxxxx
<jakartaee-
> platform-dev-bounces@xxxxxxxxxxx> On Behalf Of Kevin Sutter
> Sent: 20 May 2020 17:57
> To: jakartaee-platform developer discussions <jakartaee-platform-
> dev@xxxxxxxxxxx>
> Subject: [jakartaee-platform-dev] Inconsistency on the term "pruned"
>  
> Hi,
> As I started to update the Platform spec due to our Jakarta EE 9 
> Release Plan content, I noticed that the term "pruned" has
different
> meanings depending on the context...
> 
> In our Release Plan, we identified the following technologies as 
> "pruned", which in this context meant "removed from
the platform":
> Jakarta Stable API Project Specifications
> Jakarta XML Registries
> Jakarta XML RPC
> Jakarta Deployment
> Jakarta Management
> Support for Distributed Interoperability
in the EJB 3.2 Core 
> Specification, Chapter 10
> 
> But, if you look at theJakarta EE 8 Platform Spec, the term "pruned"
> means to only mark the technology as "optional, but it's still
part 
> of the platform" (Section 6.1.3 Pruned Java Technologies):
> 
> "Technologies that have been pruned as of Jakarta EE 8 are marked
Optional in 
> Jakarta EE Technologies."
> 
> Big difference...
> 
> First off, I'm taking the stand that we really did mean "removal"
> when we declared those technologies as "pruned" in the Jakarta
EE 9 
> Release Plan.  We've been driving that way with all of the Specs,
> APIs, TCKs, and CIs for Jakarta EE 9.  Just clarifying that 
> definition and expectation.
> 
> The point of this note is to get agreement on the direction of the
> Platform spec for these definitions.  Here's my proposal.  Comments/
> suggestions welcome.
> Change Platform spec to use
Optional instead of Pruned (in the 
> current spec context).
> Modify the definition of Pruned
to mean Removal.
> 
> For the last bullet, we could decide to just drop the term "pruned"
> and use "removed" instead.  But, since we already have
used the term
> "pruned" in the Release Plan, I think it would be more consistent
to
> just alter the definition of "pruned" to mean "removed"
in the Platform Spec.
> 
> Of course, we would need a "Note" of some type to indicate
this 
> change in terminology.
> 
> Thoughts?  I'd like to get some general feedback before embarking
on
> this type of change since it could have quite the ripple effect.  Thanks!
> 
> ---------------------------------------------------
> Kevin Sutter 
> STSM, MicroProfile and Jakarta EE architect @ IBM
> 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 unsubscribe from this list, visit https://www.eclipse.org/
> mailman/listinfo/jakartaee-platform-dev