Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Can we add Committer Members on the members page #763

Open
TanjaObradovic opened this issue May 19, 2020 · 22 comments
Open

Can we add Committer Members on the members page #763

TanjaObradovic opened this issue May 19, 2020 · 22 comments
Assignees

Comments

@TanjaObradovic
Copy link
Contributor

TanjaObradovic commented May 19, 2020

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
Copy link
Contributor

edbratt commented May 19, 2020

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
Copy link
Contributor Author

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
Copy link
Contributor

edbratt commented May 20, 2020

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
Copy link
Member

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
Copy link
Contributor

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
Copy link
Contributor Author

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
Copy link
Contributor

edbratt commented May 21, 2020

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
Copy link

aeiras commented May 21, 2020

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:

  1. 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
Copy link
Contributor Author

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
Copy link
Member

chrisguindon commented Jun 10, 2020

@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
Copy link

aeiras commented Jun 10, 2020

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
Copy link
Member

chrisguindon commented Jun 10, 2020

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
Copy link
Contributor Author

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

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

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

@chrisguindon
Copy link
Member

chrisguindon commented Jun 10, 2020

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
Copy link
Member

chrisguindon commented Jun 10, 2020

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
Copy link
Contributor Author

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

@aeiras
Copy link

aeiras commented Jun 11, 2020

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

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
Copy link
Contributor

edbratt commented Jun 11, 2020 via email

@aeiras
Copy link

aeiras commented Jun 11, 2020

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
Copy link
Member

chrisguindon commented Jun 11, 2020

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
Copy link
Contributor

@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
Copy link
Contributor Author

TanjaObradovic commented Sep 21, 2020

@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!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

7 participants