Contributor Medal Wall

[tisonkun]

This is an idea about encouraging and awarding contributions beyond the simple maintainer/committer title model.

I think the core value of contributions is what they actually achieve, not a number or a title that vaguely expresses what a contribution exactly benefits. Thus, to show what contributions a contributor creates and how those contributions concretely help the community, I propose creating a contributor medal wall page on our website showing contributions. Every contributor can make a pull request to note their own contributions, and there will be an endorsement field showing peer endorsement. Our maintainers will make the final decision to merge the pull request and show that contribution on the medal wall.

Patches will be mainly sent to the engula.github.io repo but currently, it's more like an idea than an actionable task, and I'd like to share the thought here with wider audiences. Looking forward to your thoughts and possibly I post a demo of such a page next week.

Reference:

• Find a flexible website framework to publish Engula site engula.github.io#19

[tisonkun]

cc @huachaohuang @Xuanwo @PatrickNicholas @DCjanus @PsiACE @zojw @leiysky

[huachaohuang]

@tisonkun Thanks for proposing this! But I don't know what a medal wall looks like, can you show me some examples?

Our maintainers will make the final decision to merge the pull request and show that contribution on the medal wall.

What rules/principles should the maintainer follow to make such a decision?

Patches will be mainly sent to the engula.github.io repo but currently.

Can we maintain a contributors list or something simply in the engula project?

[huachaohuang]

Any other real-world examples? To be honest, I don't see the value of listing avatars, especially in README.md.

[tisonkun]

I will describe its logic later

Basically, the contributor page shows our code contributors, and the picture example above is no more than hosting a repo and a GitHub workflow to periodically crawl information and dump into a picture. Here is the workflow file.

One limitation of the native contributor page is that it can show only up to 100 contributors, but I think it's not an urgent issue yet.

[tisonkun]

@huachaohuang to be short, I think the contributor page is sufficient for the requirement "maintain a contributors list or something simply in the engula project".

[huachaohuang]

Thanks for your explanation.

[tisonkun]

Another alternative is all-contributors and here is an example. However, I think it's too hard to maintain and actually increases the burden of maintainers. A contributor metal wall encourages contributors to share their contributions, not the responsibility of maintainers.

[tisonkun]

A community page is landed by engula/engula.github.io#20. The contributor medal wall can be introduced by extending the contributors table. To be concrete, add a new column named medals or profile which set up a link to a personal page contains contributions and blogs link, etc.

We haven't generated such values so far, and thus I leave the extension point while delivering the simple community page itself.