reworking CONTRIBUTORS file

[Paul Querna <pa...@querna.org>]

current version:
<https://svn.apache.org/repos/asf/incubator/libcloud/trunk/CONTRIBUTORS>

""""
libcloud is a collaborative project made possible by social coding.  Individual
contributions are licensed to libcloud.org under various licenses, outlined
below.  Individual drivers may be maintained by a specific party -- for patches
to a certain driver or questions regarding its maintenance, feel free to contact
the maintainer.
""""

Two issues:
 1) Everything is ASL at the ASF
 2) I think we should try to encourage potential contributions to the
mailing list, rather than contacting an individual.

I think it is good to have some metadata about a driver, beyond just
who wrote it, like what it all supports, etc, but I'm not quite sure
the CONTRIBUTORS file is the right place for it.

Any thoughts on how we should redactor & update this file?

Thanks,

Paul

Re: reworking CONTRIBUTORS file

[Tom White <to...@cloudera.com>]

Another way would be to track it through JIRA. A project may have
components, so we could have one component per driver, and each
component can have a lead developer. For an example see
https://issues.apache.org/jira/browse/HADOOP?report=com.atlassian.jira.plugin.system.project%3Acomponents-panel.

Tom

On Wed, Dec 9, 2009 at 9:04 PM, Tom Davis <to...@dislocatedday.com> wrote:
> Perhaps create a simple format to follow and stick it in the driver's
> __doc__?
>
> On Dec 9, 2009, at 11:57 PM, Paul Querna <pa...@querna.org> wrote:
>
>> current version:
>> <https://svn.apache.org/repos/asf/incubator/libcloud/trunk/CONTRIBUTORS>
>>
>> """"
>> libcloud is a collaborative project made possible by social coding.
>>  Individual
>> contributions are licensed to libcloud.org under various licenses,
>> outlined
>> below.  Individual drivers may be maintained by a specific party -- for
>> patches
>> to a certain driver or questions regarding its maintenance, feel free to
>> contact
>> the maintainer.
>> """"
>>
>> Two issues:
>> 1) Everything is ASL at the ASF
>> 2) I think we should try to encourage potential contributions to the
>> mailing list, rather than contacting an individual.
>>
>> I think it is good to have some metadata about a driver, beyond just
>> who wrote it, like what it all supports, etc, but I'm not quite sure
>> the CONTRIBUTORS file is the right place for it.
>>
>> Any thoughts on how we should redactor & update this file?
>>
>> Thanks,
>>
>> Paul
>

Re: [libcloud] Re: reworking CONTRIBUTORS file

[Tom White <to...@cloudera.com>]

A change log is a good place to list each contributor with a short
summary of the change they made. This is typically added by the
committer on each commit. E.g.
http://svn.apache.org/repos/asf/lucene/java/trunk/CHANGES.txt

Tom

On Thu, Dec 10, 2009 at 7:02 AM, Jed Smith <je...@jedsmith.org> wrote:
> On Dec 10, 2009, at 12:04 AM, Tom Davis wrote:
>
>> Perhaps create a simple format to follow and stick it in the driver's __doc__?
>
> I like this idea.
>
> I really threw CONTRIBUTORS together because the project felt like it needed
> it at that point, but this idea sounds better.  If a consistent format is adhered
> to in docstrings, regenerating static things like CONTRIBUTORS and such becomes
> a trivial matter.
>
> Jed Smith
> jed@jedsmith.org

[libcloud] Re: reworking CONTRIBUTORS file

[Jed Smith <je...@jedsmith.org>]

On Dec 10, 2009, at 12:04 AM, Tom Davis wrote:

> Perhaps create a simple format to follow and stick it in the driver's __doc__?

I like this idea.

I really threw CONTRIBUTORS together because the project felt like it needed
it at that point, but this idea sounds better.  If a consistent format is adhered
to in docstrings, regenerating static things like CONTRIBUTORS and such becomes
a trivial matter.

Jed Smith
jed@jedsmith.org

Re: reworking CONTRIBUTORS file

[Tom Davis <to...@dislocatedday.com>]

Perhaps create a simple format to follow and stick it in the driver's  
__doc__?

On Dec 9, 2009, at 11:57 PM, Paul Querna <pa...@querna.org> wrote:

> current version:
> <https://svn.apache.org/repos/asf/incubator/libcloud/trunk/CONTRIBUTORS 
> >
>
> """"
> libcloud is a collaborative project made possible by social coding.   
> Individual
> contributions are licensed to libcloud.org under various licenses,  
> outlined
> below.  Individual drivers may be maintained by a specific party --  
> for patches
> to a certain driver or questions regarding its maintenance, feel  
> free to contact
> the maintainer.
> """"
>
> Two issues:
> 1) Everything is ASL at the ASF
> 2) I think we should try to encourage potential contributions to the
> mailing list, rather than contacting an individual.
>
> I think it is good to have some metadata about a driver, beyond just
> who wrote it, like what it all supports, etc, but I'm not quite sure
> the CONTRIBUTORS file is the right place for it.
>
> Any thoughts on how we should redactor & update this file?
>
> Thanks,
>
> Paul