cyclomatic complexity, version control systems, resp. v_0
authorFrantišek Kučera <franta-hg@frantovo.cz>
Tue, 08 Oct 2019 17:21:13 +0200
branchv_0
changeset 58 204f6466c03b
parent 57 11e5656032cc
child 59 7a27e64cee67
cyclomatic complexity, version control systems, resp.
text/ssm.en.xml
--- a/text/ssm.en.xml	Mon Oct 07 16:21:02 2019 +0200
+++ b/text/ssm.en.xml	Tue Oct 08 17:21:13 2019 +0200
@@ -381,7 +381,8 @@
 		<item>
 			<id>f5389468-2f8a-43c8-884a-8df6bc844453</id>
 			<type>recommendation</type>
-			<text>Less LOC (resp. cyclomatic complexity) = better.</text>
+			<text>Less LOC (or cyclomatic complexity) = better.</text>
+			<note>Cyclomatic complexity is much better measure of the complexity than LOC (lines of code). But usually it is much easier to simply count lines and we can use it as a approximation.</note>
 		</item>
 		<item>
 			<id>b6b6c838-be6d-43d5-9f99-2098fa217c54</id>
@@ -669,7 +670,7 @@
 		<item>
 			<id>e746eb5b-8d8b-4ec8-9315-a311f35e156a</id>
 			<type>requirement</type>
-			<text>Users must not be pushed to register at a proprietary social networks resp. at particular providers of such services.</text>
+			<text>Users must not be pushed to register at a proprietary social networks (at particular providers of such services).</text>
 			<text>Users without such account must not be disadvantaged – use open and decentralized networks/protocols instead.</text>
 			<link>
 				<url>https://www.gnu.org/prep/maintain/maintain.html#Ethical-and-Philosophical-Consideration</url>
@@ -737,6 +738,7 @@
 			<id>fed07648-106a-4b7c-9026-509c82109448</id>
 			<type>requirement</type>
 			<text>Source code repository (versioning system) must be public. Do not publish just source code snapshots of released versions.</text>
+			<note>The purpose of this rule is that anybody can study who, when and why updated, created or deleted which portion of the code.</note>
 			<link>
 				<url>https://www.gnu.org/prep/maintain/maintain.html#Old-Versions</url>
 				<type>related</type>