Re: Removing in-source contribution records contributer

[Dave Martin <Dave.Martin@arm.com>]

Hi,

On Fri, May 09, 2025 at 04:39:05PM +0200, Alejandro Colomar wrote:
> Hi Dave,
> 
> On Fri, May 09, 2025 at 03:14:57PM +0100, Dave Martin wrote:
> > Hi,
> > 
> > On Fri, May 09, 2025 at 02:54:31PM +0200, Alejandro Colomar wrote:
> > > Hi all,
> > > 
> > > I've added to BCC everyone whose copyright notices have been removed
> > > (those that noted an email).  The full thread for this discussion can be
> > > found here:
> > > <https://lore.kernel.org/linux-man/jpin2dbnp5vpitnh7l4qmvkamzq3h3xljzsznrudgioox3nn72@57uybxbe3h4p/T/#u>
> > > 
> > > Please let me know if it's okay to you to transform your copyright
> > > notices to make them uniform?  That is, do you approve
> > > <https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/?id=9f2986c34166085225bb5606ebfd4952054e1657>
> > > in what affects you?
> > 
> > 
> > Should the one-line replacement statement in each file refer back to
> > the CREDITS file?
> 
> I prefer not, because then someone can copy the files to a different
> repository, without needing to modify the notices (they might take the
> CREDITS file as CREDITS_Linux-man-pages).

Fair enough, though would it make sense for the boilerplate line to at
least become

	# Copyright, The authors of the Linux man-pages project

...?

This remains meaningful out of context, but when shipped with the
original tree this wording macthes up with the naming of the AUTHORS
file (assuming that's what the file is called).


> > Also, nothing seems to say that anyone listed in CREDITS actually
> > contributed copyrightable material to the project (as opposed to, say,
> > review effort, moral support or free pizza).
> 
> I initially planned to include reviewers, etc. into CREDITS.  While
> doing that, I realized that wasn't easy, because the file would be huge,
> and would need to be updated too frequently; plus git(1) does a better
> job of documenting that with the Reviewed-by, Cc, and other tags.

Fair enough.  A line has to be drawn somewhere.


> > Renaming the CREDITS file to AUTHORS and/or clarifying this in a brief
> > top-level LICENSE / COPYING file might make the meaning clearer?
> 
> Yes, now that I discarded the idea of crediting *all* contributors, I
> agree this file should be renamed to AUTHORS.  Regarding a file solely
> to clarify that the AUTHORS file holds the copyright holders of the
> project, I guess by calling it AUTHORS it would already be obvious.  I'm
> hesitant to add another file for explaining that because the more
> uppercase files there are in the root of the repo, the harder it is to
> understand their relationship.  However, I can add something in the
> README, where I already document what each file is.

Ack, it's probably fairly obvious what a file called "AUTHORS" means.

Just a suggestion, would something like this work in README:

+   AUTHORS
+       List of individuals and organizations that have contributed
+       content to the project.
+

This will still be a true description regardless of whether the list
is complete or if non page content contributors are included.  (There
are probably plenty of borderline cases as to whether something counts
as a page content contribution or not.)

Cheers
---Dave