From 6ef9123b2228124c616441ee4f57ae7443ef3494 Mon Sep 17 00:00:00 2001 From: Daniel Gray Date: Wed, 10 Apr 2024 15:36:02 +0000 Subject: [PATCH] Reword commit and provide example --- docs/basics/common-threats.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/basics/common-threats.md b/docs/basics/common-threats.md index 7155300cb8..a206a17052 100644 --- a/docs/basics/common-threats.md +++ b/docs/basics/common-threats.md @@ -80,7 +80,7 @@ These sorts of attacks can require a lot of time and preparation to perform and 1. Only adopting popular software that has been around for a while. The more interest in a project the, the greater likelihood that external parties will notice malicious changes. A malicious actor will also need to spend more time gaining community trust with meaningful contributions. 2. Make sure software you use builds released binaries with widely-used, trusted build infrastructure platforms (i.e. GitHub workflows) as opposed to developer workstations or self-hosted servers. This is in order to reduce the attack surface and give confidence that the binaries produced are in fact produced correctly. 3. Code signing on individual commits and releases increases an auditable trail of who did what. For example: Was the malicious code in the software repository? Which developer added it? Was it added during the build process? -4. In open source projects the code should have commit messages which are explain exactly what the associated code does. This makes it easier for external parties to verify and audit, especially if the code doesn't match the description. +4. In open source projects the code should have meaningful commit messages (such as [conventional commits](https://conventionalcommits.org)) which explain what the change is supposed accomplish. Clear messages make it easier for outsiders to the project to verify, audit and find bugs. 5. Noting the number of contributors or maintainers a program has. A lone developer may be more susceptible to being coerced into adding malicious code by an external party, or to negligently enable undesirable behavior. This may very well mean software developed by "Big Tech" has more scrutiny than a lone developer who doesn't answer to anyone. ## Privacy From Service Providers