There are existing tools that do what you suggest Raphael, mostly to
put contributors into READMEs of projects but I am sure that could be
abused to put it into a Markdown file that is included in the docs.

Apache also has a site that lists all PMC members etc (that I think
uses some AJAX + a JSON file), so one could probably easily build a
tool on top of that to regularly update a list for example.

-J

Am Do., 2. Apr. 2020 um 12:04 Uhr schrieb <raphine...@gmail.com>:
>
> I know I'm pretty late to the party here, but I wanted to voice my concerns
> regarding maintainability of such a list.
>
> My experience tells me that things that won't make a CI fail and yell at
> you will get outdated pretty quickly and don't receive much maintenance.
> Some of our packages have contributors lists in their package.json for
> example. However they are not current but rather a snapshot from an
> arbitrary point in time. Actually I wanted to open some PRs for removing
> them for some time, but there had always been other, more important things
> to get done.
>
> So how about, instead of maintaining a manual list that is bound to become
> outdated quickly, we try to leverage commit data from our repositories? I
> think of something like showing the most active committers of the last two
> years or something like that. Essentially a version of GitHub's
> Contributors[1] but aggregated over all our repos. I guess something like
> that should be achievable by using GitHub's API.
> <https://github.com/apache/cordova-lib/graphs/contributors?from=2018-04-02&to=2020-04-02&type=c>
>
> If this doesn't cover all bases we could still expand upon it: Add some
> static entries (e.g. PMC Chair), or show extended member profiles/bios in
> the dynamically generated list.
>
> I'm looking forward to your opinions. And thank you Niklas for the work you
> already put in.
>
> Cheers,
> Raphael
>
> [1]
> https://github.com/apache/cordova-lib/graphs/contributors?from=2018-04-02&to=2020-04-02&type=c
>
> Am Sa., 22. Feb. 2020 um 15:55 Uhr schrieb Niklas Merz <
> niklasm...@apache.org>:
>
> > Hi everyone,
> >
> > Like discussed before I think it might be a good idea to add a page to
> > our website for Cordova users to get to know the community members.
> >
> > I am writing here because to me this only makes sense if most of the
> > active committers are involved and want to be part of this list.
> >
> > I created this PR with the first draft and some screenshots:
> > https://github.com/apache/cordova-docs/pull/1063
> >
> > There are still some open points to do and discuss. I am not the best
> > web designer and would appreciate any help. Feel free to push to this
> > branch or create PRs any time.
> >
> > Looking forward to make this happen.
> >
> > Kind regards
> > Niklas
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org
> > For additional commands, e-mail: dev-h...@cordova.apache.org
> >
> >

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@cordova.apache.org
For additional commands, e-mail: dev-h...@cordova.apache.org

Reply via email to