[sr-dev] git:master:32564156: CONTRIBUTING.md: note about formatting the code

Daniel-Constantin Mierla miconda at gmail.com
Fri Feb 9 13:53:57 CET 2018


Module: kamailio
Branch: master
Commit: 32564156a4ad3efd93099d7ae2c98758cf4ec9b0
URL: https://github.com/kamailio/kamailio/commit/32564156a4ad3efd93099d7ae2c98758cf4ec9b0

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date: 2018-02-09T13:52:58+01:00

CONTRIBUTING.md: note about formatting the code

- use clang-format or match the style of the existing component

---

Modified: .github/CONTRIBUTING.md

---

Diff:  https://github.com/kamailio/kamailio/commit/32564156a4ad3efd93099d7ae2c98758cf4ec9b0.diff
Patch: https://github.com/kamailio/kamailio/commit/32564156a4ad3efd93099d7ae2c98758cf4ec9b0.patch

---

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index e74babc78f..1705611aaa 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -31,6 +31,7 @@ In order to be easily able to track the changes and have a coherent ChangLog
 and commit history, there are several *rules* required for each contribution.
 
 ## Contributing Code Or Content ##
+
 ### Basic Rules ###
 
   * github pull requests are the favourited mechanism to submit contributions
@@ -47,7 +48,7 @@ and commit history, there are several *rules* required for each contribution.
     * a module (code inside subfolder modules/)
     * a tool (code inside subfolder utils/)
     * an example or main configs (files inside subfolders etc/ or examples/)
-  * commit messages **should** be formatted as specified in the next section
+  * commit messages **has to be formatted** as specified in the next section
   * commit message must describe the changes done by the patch
     * other details (e.g., how to reproduce, backtrace, sip packets, ...) belong
     to content (comments) of the pull request
@@ -73,6 +74,9 @@ and commit history, there are several *rules* required for each contribution.
     likely to rise merge conflicts. With separate commit, that won't be
     backported, only the commit to xml doc file, then README will be manually
     regenerated in the corresponding branch.
+  * code **should** be formatted with **clang-format** or to match the style of
+  the component that the commit applies to. The `.clang-format` file is part of
+  Kamailio source code tree, in the root folder.
 
 
 ### Commit Message Format ###
@@ -89,12 +93,12 @@ as "Subject" in the generated commit emails and it will also be used when
 generating the Changelog (e.g. git log --pretty=oneline).
 
 Please start always with the prefix of the component (subsystem) that is modified by the commit, for example:
-  * core: typo fixes to log messages
-  * tcp: stun fixes
-  * mem: added faster malloc
-  * module_name: support for foo rfc extension
-  * lib_name: critical bug fix for abc case
-  * kamctl: added support for management of module xyz
+  * `core`: typo fixes to log messages
+  * `tcp`: stun fixes
+  * `mem`: added faster malloc
+  * `module_name`: support for foo rfc extension
+  * `lib_name`: critical bug fix for abc case
+  * `kamctl`: added support for management of module xyz
 
 #### Examples Of Commit Messages ####
 




More information about the sr-dev mailing list