From 58008d1e2a9d3f3533a1e281c644ac7f91ba02b9 Mon Sep 17 00:00:00 2001 From: steverusso Date: Thu, 30 Jul 2020 03:31:09 +0000 Subject: [PATCH] Styling for code blocks. (#23) Revert back to a code block. Style for code blocks. --- assets/simplesystems.css | 8 ++++++++ content/blog/boolean_names.md | 6 +++++- 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/assets/simplesystems.css b/assets/simplesystems.css index 44a9f49..1ab0f07 100644 --- a/assets/simplesystems.css +++ b/assets/simplesystems.css @@ -340,3 +340,11 @@ button.round, .btn.round { } .blue { --clr: #42A5F5 } + +pre { + background: #eee; + border-radius: 5px; + padding-left: 1rem; + color: black; + font-size: 0.95rem; +} diff --git a/content/blog/boolean_names.md b/content/blog/boolean_names.md index 6b9adcc..33061af 100644 --- a/content/blog/boolean_names.md +++ b/content/blog/boolean_names.md @@ -20,7 +20,11 @@ A boolean name should give the reader more clarity as its scope expands. A bool ## Bad Boolean Names As with many things in software engineering, it is easier to find mistakes than to do something correctly the first time. Here are some naming conventions to avoid: 1. Names that are already a negation. 'featureTurnedOff' and 'notProd' may make sense in one use case, but they become confusing in a larger context. The following code is both hard to read and ambiguous (what if there is a third environment). -

confA.useProd := !confB.notProd

+ ```go + + confA.useProd := !confB.notProd + + ``` 2. Names that are not negatable. A name such as 'sheets' has ambiguous meaning. It probably has something to do with a spreadsheet, but it is the writer's responsibility to prevent the reader from needing to do an investigation.