You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cordova.apache.org by ra...@gmail.com on 2020/04/02 10:04:00 UTC
Re: Team page on Cordova website
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 <
niklasmerz@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-unsubscribe@cordova.apache.org
> For additional commands, e-mail: dev-help@cordova.apache.org
>
>
Re: Team page on Cordova website
Posted by Niklas Merz <ni...@apache.org>.
Good ideas. Yes a manual list will probably be outdate quickly. The interesting part for this team page is a bio/description who you are and how you work on Cordova I think. Like if you are working with Cordova on you side projectes or you are part of Company heavily invested in Cordova. Stuff like that.
Maybe we should fetch a list of all committers from the official Apache sources and sort/enricht them with the recently most active commiters and possibly their bio/description.
This definitly needs further ideas.
April 2, 2020 10:39 PM, "Jan Piotrowski" <pi...@gmail.com> wrote:
> 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 <ra...@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 <
>> niklasmerz@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-unsubscribe@cordova.apache.org
>> For additional commands, e-mail: dev-help@cordova.apache.org
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> For additional commands, e-mail: dev-help@cordova.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
Re: Team page on Cordova website
Posted by Jan Piotrowski <pi...@gmail.com>.
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 <ra...@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 <
> niklasmerz@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-unsubscribe@cordova.apache.org
> > For additional commands, e-mail: dev-help@cordova.apache.org
> >
> >
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org