diff --git a/.hunspell.en.dic b/.hunspell.en.dic index de60b2b57..b5e75815b 100644 --- a/.hunspell.en.dic +++ b/.hunspell.en.dic @@ -1214,3 +1214,4 @@ TSC coc ov readme +DCO diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index eecee3b1e..432f565fa 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -65,7 +65,7 @@ Submitting patches read the `don't be afraid to commit`_ tutorial. .. _GitHub: https://github.com/ -.. _don't be afraid to commit: https://dont-be-afraid-to-commit.readthedocs.io/en/latest/index.html +.. _don't be afraid to commit: https://afraid-to-commit.readthedocs.io/en/latest/index.html Start coding ~~~~~~~~~~~~ @@ -78,9 +78,10 @@ Start coding * Include tests that cover any code changes you make. Make sure the test fails without your patch. * `Run the tests `_ and `verify coverage `_. +* `Sign-off your commits `_. * Push your commits to GitHub and `create a pull request`_. -.. _committing as you go: https://dont-be-afraid-to-commit.readthedocs.io/en/latest/git/commandlinegit.html#commit-your-changes +.. _committing as you go: https://afraid-to-commit.readthedocs.io/en/latest/git/commandlinegit.html#commit-your-changes .. _create a pull request: https://help.github.com/articles/creating-a-pull-request/ .. _Tcl 8.5 commands reference: https://www.tcl-lang.org/man/tcl8.5/TclCmd/contents.htm @@ -234,6 +235,45 @@ Coding conventions .. _Tcl minimal escaping style: https://wiki.tcl-lang.org/page/Tcl+Minimal+Escaping+Style +.. _developer-certificate-of-origin: + +Developer Certificate of Origin (DCO) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +In order to ensure that all contributions are properly authorized and in +compliance with licensing requirements, Modules project follows the `Developer +Certificate of Origin (DCO)`_ process. The DCO is a lightweight mechanism to +certify that you, as a contributor, have the right to submit your code and +agree to the project’s licensing terms. + +How to sign off your commits +"""""""""""""""""""""""""""" + +Every commit must include a ``Signed-off-by`` line, which certifies that the +contribution adheres to the DCO. You can do this by adding the following line +at the end of your commit message:: + + Signed-off-by: Your Name + +The name and email must match your Git configuration (``git config user.name`` +and ``git config user.email``). + +To simplify the process, you can use the ``-s`` flag of ``git`` command when +committing:: + + git commit -s -m "Your commit message" + +Verifying DCO Compliance +"""""""""""""""""""""""" + +Modules repository automates checks to enforce the DCO. If your contribution +does not include the proper ``Signed-off-by`` line, the pull request check +will fail. You will need to amend your commit:: + + git commit --amend -s + +.. _Developer Certificate of Origin (DCO): https://developercertificate.org/ + .. _commit-hooks: Commit hooks diff --git a/NEWS.rst b/NEWS.rst index 989738d58..44bcedb67 100644 --- a/NEWS.rst +++ b/NEWS.rst @@ -31,6 +31,8 @@ Modules 5.6.0 (not yet released) issue #565) * Doc: advertise the `Modules chat room`_ (``#modules:matrix.org``) to discuss with the community. +* Doc: describe the :ref:`developer-certificate-of-origin` process now applied + on contributions. .. _Security policy: https://github.com/envmodules/modules/blob/main/SECURITY.md .. _Modules chat room: https://matrix.to/#/#modules:matrix.org diff --git a/doc/source/index.rst b/doc/source/index.rst index a5d86dc96..06313222d 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -141,9 +141,6 @@ A :ref:`cookbook` of recipes describes how to use the various features of Modules and how to extend the :command:`module` command to achieve specific needs. -If you have questions, comments or development suggestions for the Modules -community, please read the :ref:`CONTRIBUTING` guide. - Links -----