linux.git/Documentation/process/5.Posting.rst, branch v5.8

docs: Clarify the usage and sign-off requirements for Co-developed-by

2019-03-25T16:30:32+00:00

The documentation for Co-developed-by is a bit light on details, e.g. it
doesn't explicitly state that:

  - Multiple Co-developed-by tags are perfectly acceptable
  - Co-developed-by and Signed-off-by must be paired together
  - SOB ordering should still follow standard sign-off procedure

Lack of explicit direction has resulted in developers taking a variety
of approaches, often lacking any intent whatsoever, e.g. scattering SOBs
willy-nilly, collecting them all at the end or the beginning, etc...
Tweak the wording to make it clear that multiple co-authors are allowed,
and document the expectation that standard sign-off procedures are to
be followed.

The use of "original author" has also led to confusion as many patches
don't have just one "original" author, e.g. when multiple developers
are involved from the genesis of the patch.  Remove all usage of
"original" and instead call out that Co-developed-by is simply a way to
provide attribution in addition to the From tag, i.e. neither tag is
intended to imply anything with regard to who did what.

Provide examples to (hopefully) eliminate any ambiguity.

Cc: Tobin C. Harding 
Cc: Thomas Gleixner 
Cc: Jani Nikula 
Cc: Jorge Ramirez-Ortiz 
Cc: Jonathan Cameron 
Cc: Joe Perches 
Cc: Greg Kroah-Hartman 
Cc: Niklas Cassel 
Cc: Jonathan Corbet 
Signed-off-by: Sean Christopherson 
Signed-off-by: Jonathan Corbet

doc:process: add links where missing

2018-12-06T17:21:19+00:00

Some documents are refering to others without links. With this
patch I add those missing links.

This patch affects only documents under process/ and labels where
necessary.

Signed-off-by: Federico Vaga 
Signed-off-by: Jonathan Corbet

Documentation/process/posting: wrap text at 80 cols

2018-05-10T21:42:41+00:00

Trivial patch to adjust the text formatting to wrap at 80 columns. No
actual content has changed.

Signed-off-by: Justin Skists 
Signed-off-by: Jonathan Corbet

Documentation/process: Co-developed-by instead of Co-Developed-by

2018-02-13T21:20:38+00:00

Up to now, all commit messages have used the "d" in lower case.

Signed-off-by: Dominik Brodowski 
Signed-off-by: Jonathan Corbet

Documentation/process: add Co-Developed-by: tag for patches with multiple authors

2017-11-20T17:43:06+00:00

Sometimes a single patch is the result of multiple authors.  As git only
can have one "author" of a patch, it is still good to properly give
credit to the other developers of a commit.  To address this, document
the "Co-Developed-by:" tag which can be used to show other authors of
the patch.

Note, these other authors must also provide a Signed-off-by: tag as it
is their work that is being submitted here.

Reported-by: Thomas Gleixner 
Signed-off-by: Greg Kroah-Hartman 
Reviewed-by: Thomas Gleixner 
Acked-by: Borislav Petkov 
Signed-off-by: Jonathan Corbet

docs: fix locations of several documents that got moved

2016-10-24T10:12:35+00:00

The previous patch renamed several files that are cross-referenced
along the Kernel documentation. Adjust the links to point to
the right places.

Signed-off-by: Mauro Carvalho Chehab

docs: rename development-process/ to process/

2016-10-24T10:12:35+00:00

As we'll type this a lot, after adding CodingStyle & friends,
let's rename the directory name to a shorter one.

Signed-off-by: Mauro Carvalho Chehab