From b0c63765d1bfed841c72c6008c579cd30061440d Mon Sep 17 00:00:00 2001 From: jeff Date: Sat, 18 Jul 2020 11:57:24 -0700 Subject: [PATCH] checking in --- content/blog/boolean_names.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/blog/boolean_names.md b/content/blog/boolean_names.md index 170baf5..7de76e7 100644 --- a/content/blog/boolean_names.md +++ b/content/blog/boolean_names.md @@ -20,7 +20,7 @@ Variable names for booleans: avoid names that are already a negation (notReady, find examples in OSS (Gitea notify) -The book, _The Elements of Style_1, is a concise guide to writing. Some rules can be used as a guide for writing code as well. For example, rule 11, "Put statements in positive form," can be applied to naming boolean variables. Keep boolean names in the positive as well, with one additional requirement: do not use the positive form of a negative statement. `enabled` is in the positive form and a positive statement. `disabled` is in the positive form, but is a negative statement. `notEnabled` is both in the negative form and a negative statement. In writing, it is best to use enabled or disabled, and to avoid "not enabled"; they are more concise and stay in the positive form. The extra requirement of using a positive statement for names is because boolean variables' negations have meaning as well; in writing "not disabled" is a double negative and is discouraged. In code, `!disabled`, is also a double negative. +The book, _The Elements of Style_1, is a concise guide to writing. Some rules can be used as a guide for writing code as well. For example, rule 11, "Put statements in positive form," can be applied to naming boolean variables. Keep boolean names in the positive as well, with one additional requirement: do not use the positive form of a negative statement. `enabled` is in the positive form and a positive statement. `disabled` is in the positive form, but is a negative statement. `notEnabled` is both in the negative form and a negative statement. In writing, it is best to use enabled or disabled, and to avoid "not enabled"; they are more concise and stay in the positive form. The extra requirement of using a positive statement for names is because boolean variables' negations have meaning as well; in writing "not disabled" is a double negative and is discouraged. In code, `!disabled`, is also a double negative, and should be avoided. Read PoP and PoSD for bool blog post