[Mesa-dev] [PATCH] docs: Document the optional usage of Signed-off-by

[Jordan Justen]

This adds the "Developer's Certificate of Origin 1.1" from the Linux
kernel. It indicates that by using Signed-off-by you are certifying
that your patch meets the DCO 1.1 guidelines.

Signed-off-by: Jordan Justen <jordan.l.justen at intel.com>
Cc: Matt Turner <mattst88 at gmail.com>
---
 docs/submittingpatches.html | 53 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 52 insertions(+), 1 deletion(-)

diff --git a/docs/submittingpatches.html b/docs/submittingpatches.html
index 3f97c941aa5..5d8ba443191 100644
--- a/docs/submittingpatches.html
+++ b/docs/submittingpatches.html
@@ -20,6 +20,7 @@
 <ul>
 <li><a href="#guidelines">Basic guidelines</a>
 <li><a href="#formatting">Patch formatting</a>
+<li><a href="#signing">Patch signing</a>
 <li><a href="#testing">Testing Patches</a>
 <li><a href="#mailing">Mailing Patches</a>
 <li><a href="#reviewing">Reviewing Patches</a>
@@ -72,7 +73,9 @@ if needed.  For example:
     is necessary, and removing it causes no regressions in piglit on any
     platform.
 </pre>
-<li>A "Signed-off-by:" line is not required, but not discouraged either.
+<li>A "Signed-off-by:" line is not required, but not discouraged
+either. The format and meaning of Signed-off-by is documented below in
+the <a href="#signing">patch signing</a> section.
 <li>If a patch addresses a bugzilla issue, that should be noted in the
 patch comment.  For example:
 <pre>
@@ -128,7 +131,55 @@ Please use common sense and do <strong>not</strong> blindly add everyone.
 </pre>
 </ul>
 
+<h2 id="signing">Patch signing</h2>
 
+<p>
+  Note: Patch signing is optional for the Mesa project.
+</p>
+
+<p>
+  As described in the <a href="#formatting">patch formatting</a>
+  section, you can optionally sign your patch by including
+  Signed-off-by in the patch commit message. The Signed-off-by must
+  include your real name and email address in this format:
+</p>
+<pre>
+  Signed-off-by: Joe Hacker <jhacker at foo.com>
+</pre>
+<p>
+  By adding Signed-of-by to your contributed patch, you certify that
+  your contribution meets the guidelines of the Developer's
+  Certificate of Origin:
+</p>
+
+<pre>
+Developer's Certificate of Origin 1.1
+-------------------------------------
+
+By making a contribution to this project, I certify that:
+
+ (a) The contribution was created in whole or in part by me and I
+     have the right to submit it under the open source license
+     indicated in the file; or
+
+ (b) The contribution is based upon previous work that, to the best
+     of my knowledge, is covered under an appropriate open source
+     license and I have the right under that license to submit that
+     work with modifications, whether created in whole or in part
+     by me, under the same open source license (unless I am
+     permitted to submit under a different license), as indicated
+     in the file; or
+
+ (c) The contribution was provided directly to me by some other
+     person who certified (a), (b) or (c) and I have not modified
+     it.
+
+ (d) I understand and agree that this project and the contribution
+     are public and that a record of the contribution (including all
+     personal information I submit with it, including my sign-off) is
+     maintained indefinitely and may be redistributed consistent with
+     this project or the open source license(s) involved.
+</pre>
 
 <h2 id="testing">Testing Patches</h2>
 
-- 
2.20.0.rc1