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

docs: Update README generation #5147

Closed
wants to merge 1 commit into from

Conversation

bombsimon
Copy link
Member

  • Reword Team section to Contributors since the list is only partly team members.
  • Indicate in the contributors list who are a team member of the golangci organization
  • Update styling on the table to ensure equal sized image and name alignment
  • Always link to the user's GitHub profile instead of external web page

I don't think linking to a user's external web page is what's expected when clicking on a user's picture here on GitHub. On top of that we also don't have control on what potential sites we're linking to by doing so. Instead I think we should always link to the GitHub profile page and if someone want's to visit the web page from there they can click on the link in the profile.

While exploring this I noticed a few other things that I was addressing since they felt related. I reworded the list to contributors since it's not actually the team or team members. To address that I also made an extra call to the organization's team page to flag contributors who's also team members. This is not optimal and could be handled with a single call and some more code changes but given that the pipeline takes 1h 12m I don't think an extra roundtrip and loop over 500 items really matters.

Lastly since the images and alignment was rendered differently if the name was long enough to cause a line break I added some styling for that as well.

- Reword `Team` section to `Contributors` since the list is only partly
  team members.
- Indicate in the contributors list who are a team member of the
  `golangci` organization
- Update styling on the table to ensure equal sized image and name
  alignment
- Always link to the user's GitHub profile instead of external web page
@ldez
Copy link
Member

ldez commented Nov 21, 2024

I agree with your PR.

I also think replacing this section with something simpler, because, as you said, it takes more than 1 hour to generate.

I think we should keep contributors but with something simpler, like inside the homepage https://golangci-lint.run/.

And keep the "sort by activities" only for team members.

@ldez ldez added enhancement New feature or improvement area: ci PR that update CI labels Nov 21, 2024
@bombsimon
Copy link
Member Author

I also think replacing this section with something simpler, because, as you said, it takes more than 1 hour to generate.

Yeah I was thinking of removing name-your-contributors because that seems to be what's taking time but I didn't explore much since I didn't want to make this too big of an change right now.

I guess if we only take contributors from the contributors API we wouldn't need any more stats for them, however name-your-contributors doesn't seem to allow specifying a specific set of users so we would have to poll PRs and issues and reactions etc for each team member to sort them accordingly.

I would probably have to spend way more time figuring this out hence I filed this PR to fix styling and title short term.

@ldez
Copy link
Member

ldez commented Nov 21, 2024

<a href="https://github.com/golangci/golangci-lint/graphs/contributors"><img src="https://opencollective.com/golangci-lint/contributors.svg?width=890" /></a>

@ldez
Copy link
Member

ldez commented Nov 21, 2024

FYI I already tried to hack with name-your-contributors and it was deceptive.

@ldez
Copy link
Member

ldez commented Nov 21, 2024

If you agree, I propose to remove all the sections (and the CI process) to just use the contributors list #5147 (comment)

In the future, we can improve or extend that, but it can be a good first step.

@bombsimon
Copy link
Member Author

If you agree, I propose to remove all the sections

This sounds way better and simpler! Sure, I'll miss my face there, but I'll survive!

Closing this in favor of #5148

@bombsimon bombsimon closed this Nov 21, 2024
@ldez ldez added declined and removed enhancement New feature or improvement labels Nov 21, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants