Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakarta.ee-spec.committee] GitHub repository naming conventions?

I think we've left the poll open long enough:  https://doodle.com/poll/efb2ym6zmvr55ey6

Looks like the the use of two repositories (one for spec and api, and the other for tck) is the preferred configuration (ala CDI).  We should probably communicate this through the PMC?  Will this just be a strong suggestion or will this be required?  Thanks.

---------------------------------------------------
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:        Scott Stark <sstark@xxxxxxxxxx>
To:        Bill Shannon <bill.shannon@xxxxxxxxxx>
Cc:        Jakarta specification committee <jakarta.ee-spec.committee@xxxxxxxxxxx>, jakarta.ee-spec.committee-bounces@xxxxxxxxxxx
Date:        06/20/2019 05:47 PM
Subject:        [EXTERNAL] Re: [jakarta.ee-spec.committee] GitHub repository naming        conventions?
Sent by:        jakarta.ee-spec.committee-bounces@xxxxxxxxxxx




I did set on up and sent an invite to this list.
https://doodle.com/poll/efb2ym6zmvr55ey6

We still should have a recommended structure that we define in the JESP operations guide.


On Jun 20, 2019, at 3:32 PM, Bill Shannon <bill.shannon@xxxxxxxxxx> wrote:

Do you want to set up a Doodle poll?  :-)

And you-know-who will tell us that each project should make their own decision so there's no need for a vote.  :-)

Scott Stark wrote on 6/20/19 3:20 PM:
For Jakarta EE 8 I think it is now clear that the committers on a spec project will have access to spec, api and tck as we are not going to look to create separate TCK projects. Down the road I believe we should have separate TCK projects.

For a given spec project X, there are three legitimate options as far as I can see:

1. one repo with the 3 content roots. This is what MicroProfile does.
X/{api, spec, tck}

2. Two repos with api and spec contents under X-spec, and the TCK in the X-tck repo. This is how CDI is structured.
X-spec/{api, spec}
X-tck

3. Three repos with api, spec and TCK contents each under a separate repo:
X-api
X-spec
X-tck

We might as well simply run a vote on what the preferred structure is for Jakarta EE 8.



On Jun 20, 2019, at 11:24 AM, Bill Shannon <bill.shannon@xxxxxxxxxx> wrote:

Again, projects and repos are not one-to-one.  We started talking about how many repos we should have and what they should be named.  Now it seems that some of you want multiple Eclipse projects to hold these repos, instead of having all the repos be part of the specification project.

I understand having the TCK be a separate project.  At Sun/Oracle the people working on the TCKs were not the same people working on the spec.  But since the spec document and the javadocs together are "the spec", having them in the same project makes sense.

We really need to come to some agreement soon since Wayne's about to make these changes.  My understanding is that the "plan of record" is that the API, spec document, and TCK will all be part of the corresponding Eclipse spec project (understanding that we don't yet have separate TCK repos for many of these specs).  If we need separate Eclipse projects for some of these items, we need to start the project creation process.

Personally, I'm fine with putting it all in the spec project.  I'm also fine with having a separate TCK project.  And again, personally, I prefer three repos (spec doc, API, TCK), but would live with two (spec doc + API, TCK) if that was the consensus for all projects.


Richard Monson-Haefel wrote on 6/20/19 7:22 AM:
I think its best to separate API, Spec, and TCK.  Different people will be working on these. For example, Joe from ABC corp might be working on the spec, but its Jill from ABC Corp who is doing the API adjustments/creation and Wanda from ABC Corp doing the TCK.  We don't want JIll or Wanda on the Spec project.  that's Joe's job.

On Wed, Jun 19, 2019 at 2:10 PM Kevin Sutter <sutter@xxxxxxxxxx> wrote:
That is my understanding as well, Bill.  I thought the long term goal was to have the TCKs in separate projects, but we were not going to enforce that at this time.


---------------------------------------------------
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:        
Bill Shannon <bill.shannon@xxxxxxxxxx>
To:        
Scott Stark <sstark@xxxxxxxxxx>
Cc:        
Jakarta specification committee <jakarta.ee-spec.committee@xxxxxxxxxxx>
Date:        
06/19/2019 12:11 PM
Subject:        
[EXTERNAL] Re: [jakarta.ee-spec.committee] GitHub repository naming        conventions?
Sent by:        
jakarta.ee-spec.committee-bounces@xxxxxxxxxxx




My understanding is that that would require them to be separate Eclipse projects, which is not the current plan.

Yes, if someone wanted to be a Committer on a TCK without their IP being contributed to the corresponding spec, we would need them to be separate projects.


Scott Stark wrote on 6/19/19 9:28 AM:
That should not be necessary in terms of IP capture. The TCK is an implementation of a testing framework for the spec, not a specification document that expands the IP commitments. We should be able to have committers to a TCK that are not committers to a spec.


On Jun 19, 2019, at 8:59 AM, Bill Shannon <
bill.shannon@xxxxxxxxxx> wrote:

Since they're all part of the same Eclipse project, they all share the same set of committers.

Scott Stark wrote on 6/19/19 7:33 AM:
We have found that a convenient organization in our projects as it best matches the committer issues. The TCK should have a wider committer list than the specs/apis.

On Jun 18, 2019, at 10:58 PM, Bill Shannon <
bill.shannon@xxxxxxxxxx> wrote:

Why do you think they should all be in the same repo?

Clearly the spec, API, and TCK will all be part of the same project, which controls who has permission to do what.  Why would two of them be in one repo and one of them in another repo?


Scott Stark wrote on 6/18/19 9:20 PM:
I do believe the spec and api should be in the same repo. The TCKs should be in a separate repo.

github.com/eclipse-ee4j/wombat-spec/{spec, api}
github.com/eclipse-ee4j/wombat-tck




_______________________________________________
jakarta.ee-spec.committee mailing list

jakarta.ee-spec.committee@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit

https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee



_______________________________________________
jakarta.ee-spec.committee mailing list

jakarta.ee-spec.committee@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit

https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee


--
Richard Monson-Haefel
https://twitter.com/rmonson
https://www.tomitribe.com/

_______________________________________________
jakarta.ee-spec.committee mailing list
jakarta.ee-spec.committee@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee


_______________________________________________
jakarta.ee-spec.committee mailing list

jakarta.ee-spec.committee@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit

https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee


_______________________________________________
jakarta.ee-spec.committee mailing list
jakarta.ee-spec.committee@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee


_______________________________________________
jakarta.ee-spec.committee mailing list
jakarta.ee-spec.committee@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee




Back to the top