Now that MAINTAINERS is generated from MAINTAINERS.yml, update the
legal prerequisites section describing out to permanently record a
DCO.

Whilst here, note that adding a DCO record to the MAINTAINERS file is
permanent - that is, a new entry should be added if you change your
email address.  Old addresses need to be retained in perpetuity.
---

Changes since v1
 - fix error in commit message
 - Tweak text around DCO entries as per feedback
 - minor formatting changes and clarifications.
 
 htdocs/contribute.html | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/htdocs/contribute.html b/htdocs/contribute.html
index 64840c32..ff6b29c1 100644
--- a/htdocs/contribute.html
+++ b/htdocs/contribute.html
@@ -53,11 +53,21 @@ your request.</p>
 
 <p>Alternatively, a contributor can certify the
 <a href="https://developercertificate.org";>Developer Certificate of Origin</a>
-for their contribution by adding
+(DCO) for their contribution by adding
 the <a href="dco.html"><code>Signed-off-by:</code></a> tag to their submission.
 Contributors with <a href="gitwrite.html">commit access</a> can certify the
-DCO for all future commits by adding their name to the DCO list in the
-MAINTAINERS file.
+DCO for all future commits by adding one or more <code>DCO</code> entries
+to your list of roles in the <code>MAINTAINERS.yml</code> file, then using
+<code>contrib/gen-MAINTAINERS.py</code> to check and rebuild the
+MAINTAINERS file.  Finally, the modified files should be committed to
+the development branch of the compiler.  Adding DCO records for
+yourself in this way is considered obvious and does not require
+approval from other maintainers.</p>
+
+<p>DCO entries in the MAINTAINERS file form a permanent
+record: <strong>they must not be removed</strong> once you have used that email
+address to commit code.  If your email address changes you must
+add a new entry to cover future commits under the DCO.</p>
 
 <p>We can accept
   <a 
href="https://www.gnu.org/prep/maintain/maintain.html#Legally-Significant";>small
 changes</a>
-- 
2.43.0

Reply via email to