Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 18 May 2018 23:33:57 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 228353] articles/committers-guide: Document "Sponsored by:" commit log line
Message-ID:  <bug-228353-9@https.bugs.freebsd.org/bugzilla/>

next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D228353

            Bug ID: 228353
           Summary: articles/committers-guide: Document "Sponsored by:"
                    commit log line
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Documentation
          Assignee: doc@FreeBSD.org
          Reporter: john@saltant.com

Created attachment 193524
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=3D193524&action=
=3Dedit
articles/committers-guide: Document "Sponsored by"

Problem statement
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

1.  The "Sponsored By" line is not documented in the Committers' Guide, thr=
ough
it has been included in the FreeBSD-specific patch to the devel/subversion =
port
since March, 2013 [0].

2.  Common practice for using the "Sponsored By" line does not handle well =
the
case where a commit is the result of work by multiple individuals who typic=
ally
have different sponsorship including some who have no sponsorship at all. In
this case, a sponsorship credit tends to have the unintended implication th=
at
the work of all collaborators was sponsored and by the same sponsor, which =
is
rarely the case.

[0] https://svnweb.freebsd.org/changeset/ports/314983


Discussion
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

A preliminary discussion of the problem statement and the concept for this
patch took place on the freebsd-ports@ list [1].

[1] https://lists.freebsd.org/pipermail/freebsd-ports/2018-May/113352.html


Proposed solution
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

The attached patch contributes documentation (in English) to address both p=
arts
of the problem statement.


Translations
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

The Committers' Guide is offered in English, French, Italian, and Russian, =
so a
full solution should include patches for the other three languages.

--=20
You are receiving this mail because:
You are the assignee for the bug.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-228353-9>