Can we add Committer Members on the members page

TanjaObradovic commented 4 years ago

Under https://jakarta.ee/membership/members/ and below Participant Members please add section Committer Members and list names of all committer members involved with Jakarta EE.

edbratt commented 4 years ago

Is this a request to produce a list of committer members to each EE4J Project, qualified by the committer member organizations that listed on the membership/members page? (i.e. for Red Hat, list all contributors with committer roles in EE4J ... and do the same for all organizations listed?)

TanjaObradovic commented 4 years ago

This is a request to find a way to list all committer members including both 1)committers employed by Jakarta EE member organizations as well as 2) individual committer members not employed by a Jakarta EE member organization.

edbratt commented 4 years ago

So, this would be the uniqued list of everyone listed on all the EE4J project "Who is involved" pages (minus the mentors, I guess). Correct? That number is approaching 200 names. Seems like a large list of names. I don't have an objection but I do wonder, what value this will serve. This data is already available to anyone sufficiently diligent to click through those user page tables. Due to its size, I don't know if I would put it directly on the members page. Maybe a sub-page, or something requiring a click to expand?

ivargrimstad commented 4 years ago

How about displaying the Individual Committer Members? That is, those that are not employed by a member company but have signed the paperwork as individuals.

shabnammayel commented 4 years ago

Maybe add a "Committer Members" button or "Individual Committer Members" button in the banner which goes to a page that features them? I think we should keep the member organizations list and page separate from Committer members list

TanjaObradovic commented 4 years ago

Thanks all for the discussion, we want to find an optimal and reasonable way of exposing the information. Currently I am thinking we should have a section for Committer Members and list number of them, and possibly a button or a link that will lead to all Committer Members names.

edbratt commented 4 years ago

If this is valuable, it may be valuable to other working groups. Perhaps also consider if this would make sense at the working group home-page (e.g.https://projects.eclipse.org/projects/ee4j). Generating this list manually would be lots of work and perpetually out of date. I hope that isn't being considered.

aeiras commented 4 years ago

Hola everyone,

@edbratt you hit the nail on the need to make the space be populated via Git and feed to the page automatic.

Allow me to interject in this ticket and use MicroProfile Contributors' page as an example: MP Contributors Page

Value

automatic updates using Git, the tool of the project is necessary. If the page requires individual managing, it ought to not exist as there is no value on such waist of time
the page welcomes anyone via actions to be listed as a Contributor. For MP, we choose not to separate Committers & Contributors. We understand that both are relevant and equally important to the project ecosystem.
Tha landing page has a Call to Action that brings you to the main adoc that tells anyone how to become involved and welcomes anyone to add via PRs more stuff to the list of how.
Using Git tooling to populate the page means that the contributors are in GIT, this is the most valuable stuff b/c each pic under MP contributor if you click it it tells you how that contributor is via its activity in git. Exactly what we need.

Lastly, I recommend that:

a new Tab is created to focus on Contributors or Committers (lets ask the community what they prefer by informal doodle poll)
Mindful that Contributors can be anyone not only coders, the minimum requirement is to help via git, etc. With translations activities happening right now, we know that code is just 1 way to contributed. There are speakers, writers, designers, branding, etc. All valuable.

To earn commit status is still a vacuum under the Jakarta EE project, I lean towards acknowledging anyone who is proactively moving the project forward instead of just focusing on the Committers, who are 165 today. -

TanjaObradovic commented 4 years ago

Thanks for the input. I think we should proceed with this request in the following way: Please add under https://jakarta.ee/membership/members/ and below Participant Members, a new section Committer Members and present a pie chart listing committer members based on their association with organizations + one section that will list individual committer members. This should be very similar to the pie chart "Organization Contribution Activity" on the page https://projects.eclipse.org/projects/ee4j/who but once you hover over the section it will list the names of committer members. @chrisguindon please let me know if any issues with this approach.

chrisguindon commented 4 years ago

@TanjaObradovic From a technical perspective, my only concern right now is that we would need to build an API to allow us to fetch this data from projects.eclipse.org via jakarta.ee before we can implement this.

aeiras commented 4 years ago

Hola Chris,

To build the API to automatically fetch the data how long will it take? Your concern seems time, am I assuming correctly? If there are issues with implementation, this needs to be brought up for further discussion to the Steering Committee. Page is important to the project as such, it levels to highest table. :) Thanks for being awesome!

chrisguindon commented 4 years ago

Hi @aeiras,

At the moment, I am not too concerned about the request or the work.

We currently have a few on-going projects and I am losing a member of my team for a few weeks soon.

It will be hard for me to commit to new projects during that period.

What is the expectation for this to get done?

TanjaObradovic commented 4 years ago

@chrisguindon I think we can be patient for this. Maybe - if easier do it in 2 phases if it helps and makes sense

phase one - pie chart listing committer members based on their association with organizations + one section that will list individual committer members.
Adding names once you hover over the section

If this come back to building API - we can wait.

chrisguindon commented 4 years ago

This would require some changes to our Project API.

With this said, here's what we can do soon with a bit of work:

Each time we deploy an update to jakarta.ee, we fetch metadata for each Jakarta EE project from our API's.

This data includes a list of committers for each project. I can use this information to create an HTML list of all the unique committers for Jakarta EE. We could also add a link to the Eclipse Profile page of each committer.

For example:

This is the data that I can use now. Anything missing from this file will require some work to our APIs:

eclipsefdn_projects.yaml.zip

chrisguindon commented 4 years ago

You will notice that I don't have the full name of our committers in the data file but I believe I can add it without investing too much time.

TanjaObradovic commented 4 years ago

@chrisguindon, yes, lets list them (for now) as you are suggesting and in the style of meeting minutes.

aeiras commented 4 years ago

This would require some changes to our Project API.

With this said, here's what we can do soon with a bit of work:

Each time we deploy an update to jakarta.ee, we fetch metadata for each Jakarta EE project from our API's.

This data includes a list of committers for each project. I can use this information to create an HTML list of all the unique committers for Jakarta EE. We could also add a link to the Eclipse Profile page of each committer.

For example:

Tanja Obradovic

Christopher Guindon

Amelia Eiras

This is the data that I can use now. Anything missing from this file will require some work to our APIs:

eclipsefdn_projects.yaml.zip

this sounds wonderful step forward @chrisguindon, thank you and everyone involved in this task! :)

Chris, i adore your example. Currently, the Jakarta EE project doesn't recognize business contributions as part of earning committer status. Lets see if we can change that in the future by its community. Thats the reason TT has not assigned anyone in the business side of the project, currently active, to a committer. Cheers!

edbratt commented 4 years ago

Committer lists don't change much. I'm not sure you need to do this for every new deployment. If it's not time-consuming, probably that doesn't matter. But if this query is lengthy, maybe updating this once a week or perhaps even monthly would suffice.

On 6/11/2020 11:03 AM, Amelia Eiras wrote:

This would require some changes to our Project API.

With this said, here's what we can do soon with a bit of work:

Each time we deploy an update to jakarta.ee, we fetch metadata for
each Jakarta EE project from our API's.

This data includes a list of committers for each project. I can
use this information to create an HTML list of all the unique
committers for Jakarta EE. We could also add a link to the Eclipse
Profile page of each committer.

For example:

  * Tanja Obradovic <https://accounts.eclipse.org/users/tobradovic>
  * Christopher Guindon <https://accounts.eclipse.org/users/cguindon>
  * Amelia Eiras <https://accounts.eclipse.org/users/aeiras>

This is the data that I can use now. Anything missing from this
file will require some work to our APIs:

eclipsefdn_projects.yaml.zip
<https://github.com/jakartaee/jakarta.ee/files/4760645/eclipsefdn_projects.yaml.zip>
this sounds wonderful step forward @chrisguindon https://github.com/chrisguindon, thank you and everyone involved in this task! :)

Chris, i adore your example. Currently, the Jakarta EE project doesn't recognize business contributions as part of earning committer status. Lets see if we can change that in the future by its community. Thats the reason TT has not assigned anyone in the business side of the project, currently active, to a committer. Cheers!

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/jakartaee/jakarta.ee/issues/763#issuecomment-642844062, or unsubscribe https://github.com/notifications/unsubscribe-auth/AC5WM3USR6JWGIFB47AUST3RWEL6BANCNFSM4NFEAI5A.

aeiras commented 4 years ago

agreed @edbratt. But Chris hasn't told us how this temporary fix could be sustain until the API is a reality. Lets see what his recommendation is. I am very against taking human time from tools that ought to provide that data instead of human managing. Yet I do like the solution for now. :) it is an improvement!

chrisguindon commented 4 years ago

I am sorry if I my comment is causing some confusion.

My suggestion is an automated process.

We will be using public data that's currently available in our API. I just need to make a small change to the API to include the full name of each committer and we will be able to implement the list of committers.

Adding the full name of the committer is less work than adding the data required to build the chart from the initial request.

autumnfound commented 4 years ago

@TanjaObradovic is the idea with the list to display each projects' committers separately or to have a large flat list of every unique committer?

TanjaObradovic commented 4 years ago

@autumnfound the idea is to have flat list of every unique committer. I was just about ask fro progress and realized you are waiting for me!

jakartaee / jakarta.ee

Can we add Committer Members on the members page #763