On 21 July 2011 12:07, Hannes Magnusson <hannes.magnus...@gmail.com> wrote:
> On Thu, Jul 21, 2011 at 20:14, Adam Harvey <ahar...@php.net> wrote:
>> On 21 July 2011 07:15, Hannes Magnusson <hannes.magnus...@gmail.com> wrote:
>>> A (short) list of "authors" or a "group" needs to exist due to licensing 
>>> issues.
>>> How to generate that one I've no idea.
>>
>> Are you sure about that? I think you'll find that copyright is held by
>> all contributors individually, so it's actually more accurate to point
>> to the entire list for licensing purposes.
>
> That would mean we would need the approval of every single person in
> that gigantic list to change the license.
> It was hard enough to track down and contact the less-then-10 people lasttime

Yep. That's why Wikipedia had to get the GFDL changed to allow them to
convert to CC — it was the only feasible way of doing it, since they
couldn't contact all their contributors.

It is a pain.

>>> I would like a "NEWS"/"ChangeLog" listing, similar to what php-src does.
>>> That would serve the dual purpose of improving crediting of people
>>> actually working on the docs on daily basis, and letting the user know
>>> what is new within the docs (so he can pay attention to modifications
>>> to his favorite doc page), and bugfixes etc etc.
>>
>> It would be nice. We should be able to auto-generate something,
>> really, based on commits.
>
>
> I don't like the idea of autogenerating such list. The black list
> would be painful to manage (i.e. how would remove WS commits and
> random weirdness?)

I wouldn't even try to. They're not that big a percentage of our commits.

> I'm sure it will take few weeks to get used to update a "NEWS" file on
> every bugfix/new additions, and drive-by-committers will probably not
> to do.. but in the longterm I still think its a better option.
>
> We could then manually rotate the list every once in a while, or even
> create a rule in PhD to only list the last "100 entries" or whatever.

How's this going to integrate with the online doc editor?

Adam

Reply via email to