From ea2fe05037cde7ceaf9d8d9be2b5d90c598f6282 Mon Sep 17 00:00:00 2001 From: Zaine Arch Date: Thu, 28 Aug 2025 17:41:03 +0100 Subject: [PATCH] Auto-publish on Thu 28 Aug 17:41:03 BST 2025 --- output/about.html | 8 +- output/assets/styles/style.css | 15 + output/blogs/2025/08/benefits-of-reading.html | 50 ++-- output/blogs/2025/08/hilberts.hotel.html | 2 +- ...pending-the-whole-day-on-this-website.html | 8 +- output/blogs/2025/08/third-time.html | 278 ++++++++++++++++++ output/blogs/2025/08/wacom-with-arch.html | 8 +- ...kly-review-week-ending-august-10-2025.html | 54 ++-- ...kly-review-week-ending-august-17-2025.html | 78 ++--- ...kly-review-week-ending-august-24-2025.html | 28 +- .../08/what-do-i-want-to-do-with-emacs.html | 4 +- output/blogs/2025/08/zettelkasten.html | 10 +- output/blogs/blogs-intro.html | 8 +- output/blogs/blogs-list.html | 11 +- output/categories.html | 12 +- output/contact.html | 8 +- output/index.html | 26 +- output/posts.html | 18 +- .../clean-code/clean-code-chapter-1.html | 10 +- .../clean-code/clean-code-chapter-2.html | 122 ++++---- .../clean-code/clean-code-chapter-3.html | 66 ++--- .../clean-code/clean-code-chapter-4.html | 186 ++++++------ .../clean-code/clean-code-chapter-5.html | 114 +++---- output/posts/posts-intro.html | 8 +- output/posts/posts-list.html | 10 +- output/setup.html | 20 +- output/sitemap.html | 6 +- output/tags/books.html | 10 +- output/tags/education.html | 10 +- output/tags/emacs.html | 10 +- output/tags/insights.html | 11 +- output/tags/introduction.html | 10 +- output/tags/maths.html | 10 +- output/tags/notes.html | 10 +- output/tags/reading.html | 10 +- output/tags/review.html | 10 +- output/tags/website.html | 10 +- output/tags/weekly-review.html | 10 +- 38 files changed, 787 insertions(+), 492 deletions(-) create mode 100644 output/blogs/2025/08/third-time.html diff --git a/output/about.html b/output/about.html index 90d9dee..526f01b 100644 --- a/output/about.html +++ b/output/about.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + About Page @@ -217,9 +217,9 @@
Updated: 2025-08-08 Fri 23:07
-
-

About

-
+
+

About

+

TODO

diff --git a/output/assets/styles/style.css b/output/assets/styles/style.css index 6dffb3a..8182c6c 100644 --- a/output/assets/styles/style.css +++ b/output/assets/styles/style.css @@ -176,6 +176,21 @@ footer{ box-sizing: border-box; } +/* Make margin notes stack instead of overlapping */ +.sidenote, +.marginnote{ + display: block; /* spans -> blocks so clearing works predictably */ + clear: right; /* each note starts below the previous right-floated note */ +} + +/* Add a little spacing between consecutive notes in the margin */ +.sidenote + .sidenote, +.sidenote + .marginnote, +.marginnote + .sidenote, +.marginnote + .marginnote{ + margin-top: .4rem; +} + /* Optional: show the same footnote number in the margin */ .footnote-sidenote::before{ content: attr(data-fn) " "; diff --git a/output/blogs/2025/08/benefits-of-reading.html b/output/blogs/2025/08/benefits-of-reading.html index e55a911..dc63175 100644 --- a/output/blogs/2025/08/benefits-of-reading.html +++ b/output/blogs/2025/08/benefits-of-reading.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Benefits of Reading @@ -224,60 +224,60 @@

Table of Contents

-
-

Benefits 1

-
+
+

Benefits 1

+

At times, I find myself being able to digest material more quickly and efficiently, and so I thought to myself as to what the probable cause of this was. The answer transpired to be the inculcating of reading in my daily routine. As humans, we are constantly surrounded with information, some are noisy, some are useful. We can choose to filter out noisy information by limiting exposure of their avenues, however the topic I wanted to briefly touch upon is what are the (cognitive and non-cognitive) benefits of increasing the intake of useful information through the medium of reading?

-
-

Mental Stimulation

-
+
+

Mental Stimulation

+

The brain is a muscle, in order to keep any muscle strong and healthy, it needs stimulation and attention. Thus, reading is an excellent way of ensuring the brain is fit and healthy.

-
-

Stress Reduction

-
+
+

Stress Reduction

+

A well written novel or informative book can go a long way in making you forget about the worries of the world.

-
-

Increase in Knowledge

-
+
+

Increase in Knowledge

+

Reading will always fill your head with new information.

-
-

Entertainment

-
+
+

Entertainment

+

A plethora of genres can keep anyone entertained!

-
-

Better writing skills

-
+
+

Better writing skills

+

Being exposed to different writing styles allows you to be influenced to obtaining your own unique writing style.

diff --git a/output/blogs/2025/08/hilberts.hotel.html b/output/blogs/2025/08/hilberts.hotel.html index 1f2d854..2ef7546 100644 --- a/output/blogs/2025/08/hilberts.hotel.html +++ b/output/blogs/2025/08/hilberts.hotel.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Hilbert's Hotel diff --git a/output/blogs/2025/08/spending-the-whole-day-on-this-website.html b/output/blogs/2025/08/spending-the-whole-day-on-this-website.html index 192a33a..39a2a93 100644 --- a/output/blogs/2025/08/spending-the-whole-day-on-this-website.html +++ b/output/blogs/2025/08/spending-the-whole-day-on-this-website.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + 09-08-2025: Website Changes @@ -220,9 +220,9 @@

09-08-2025: Website Changes

emacs website
-
-

What was worked on

-
+
+

What was worked on

+

I saw a few websites that used marginal notes on the right side of the screen like this one, so I decided to try and implement this feature in this wesbite. In my mind I thought of using an external pre-configured CSS that I can just insert and ta-da it would work.

diff --git a/output/blogs/2025/08/third-time.html b/output/blogs/2025/08/third-time.html new file mode 100644 index 0000000..a368dae --- /dev/null +++ b/output/blogs/2025/08/third-time.html @@ -0,0 +1,278 @@ + + + + + + + +Third Time + + + + + + + + + + + + +
+ + +
Updated: 2025-08-28 Thu 17:40
+
+
+

Third Time

+
insights
+ +
+

Table of Contents

+
+ +
+
+
+

A more structured way of working

+
+

+ Useful for people who don't like the constrained working limit of 25 minutes for instance. +

+ +

+Whilst researching for different ways to use pomodoro 1 on Emacs 2, I came across this package titled: pomm.el. In this package it had an interesting feature called pomm-third-time3. The ideology behind is as follows: +

+
    +
  • You work as long as you want.
    • +
  • Your break is calculated using the formula: Time of break = 1/3 x Time of work.
    • +
  • If you take a shorter break, the remaining break time is accumulated and added to the next break (within the same session).
    • +
+
+
+
+
+
+
+
+Copyright © 2022-2025 Zaine Qayyum. All rights reserved unless otherwise noted.
+
+Created with Emacs 30.1 (Org mode 9.7.11) on Arch GNU/Linux +
+
+
+ + diff --git a/output/blogs/2025/08/wacom-with-arch.html b/output/blogs/2025/08/wacom-with-arch.html index 48774c9..94303e6 100644 --- a/output/blogs/2025/08/wacom-with-arch.html +++ b/output/blogs/2025/08/wacom-with-arch.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Wacom With Arch @@ -220,9 +220,9 @@

Wacom With Arch

insights
-
-

Setting up Wacom Tablet in Arch Hyprland

-
+
+

Setting up Wacom Tablet in Arch Hyprland

+

I purchased a One by Wacom tablet almost 2 years ago now and it works flawlessly in both Windows and MacOS and even in most Linux distros with some configuration.

diff --git a/output/blogs/2025/08/weekly-review-week-ending-august-10-2025.html b/output/blogs/2025/08/weekly-review-week-ending-august-10-2025.html index e1d945c..58ef8c4 100644 --- a/output/blogs/2025/08/weekly-review-week-ending-august-10-2025.html +++ b/output/blogs/2025/08/weekly-review-week-ending-august-10-2025.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Weekly review: Week ending August 10, 2025 @@ -224,23 +224,23 @@

Table of Contents

-
-

Reviewing the week

-
+
+

Reviewing the week

+

Mostly continuing reading from the book clean code, also setup the ankii cards and this website. The amount of leetcode problems I solved could improve however.

@@ -254,27 +254,27 @@ I'm thinking of using time-blocks to represent the hours I spent doing each thin

-
-

Next week

-
+
+

Next week

+
-
-

DONE Read as much of Clean Code as possible

+
+

DONE Read as much of Clean Code as possible

-
-

TODO Finish another (misc) book

+
+

TODO Finish another (misc) book

-
-

DONE Write more (metric unspecified, need to experiment to see what works best)

+
+

DONE Write more (metric unspecified, need to experiment to see what works best)

-
-

TODO Start the book Dose Effect

+
+

TODO Start the book Dose Effect

-
-

DONE More leetcode problems to solve (again, metric unspecified)

+
+

DONE More leetcode problems to solve (again, metric unspecified)

-
-

TODO Touch typing: daily practice

+
+

TODO Touch typing: daily practice

diff --git a/output/blogs/2025/08/weekly-review-week-ending-august-17-2025.html b/output/blogs/2025/08/weekly-review-week-ending-august-17-2025.html index e9f4bd9..7911ced 100644 --- a/output/blogs/2025/08/weekly-review-week-ending-august-17-2025.html +++ b/output/blogs/2025/08/weekly-review-week-ending-august-17-2025.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Weekly review: Week ending August 17, 2025 @@ -224,65 +224,65 @@

Table of Contents

-
-

Previous Week

-
+
+

Previous Week

+
-
-

DONE Read as much of Clean Code as possible

+
+

DONE Read as much of Clean Code as possible

-
-

TODO Finish another (misc) book

+
+

TODO Finish another (misc) book

-
-

DONE Write more (metric unspecified, need to experiment to see what works best)

+
+

DONE Write more (metric unspecified, need to experiment to see what works best)

-
-

TODO Start the book Dose Effect

+
+

TODO Start the book Dose Effect

-
-

DONE More leetcode problems to solve (again, metric unspecified)

+
+

DONE More leetcode problems to solve (again, metric unspecified)

-
-

TODO Touch typing: daily practice

+
+

TODO Touch typing: daily practice

-
-

Next Week

-
+
+

Next Week

+
-
-

TODO 3/4 of Clean Code

+
+

TODO 3/4 of Clean Code

-
-

TODO More book notes

+
+

TODO More book notes

-
-

TODO Touch typing: daily practice

+
+

TODO Touch typing: daily practice

-
-

TODO Start the book Dose Effect

+
+

TODO Start the book Dose Effect

diff --git a/output/blogs/2025/08/weekly-review-week-ending-august-24-2025.html b/output/blogs/2025/08/weekly-review-week-ending-august-24-2025.html index 2f2d905..a6bbdfa 100644 --- a/output/blogs/2025/08/weekly-review-week-ending-august-24-2025.html +++ b/output/blogs/2025/08/weekly-review-week-ending-august-24-2025.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Weekly review: Week ending August 24, 2025 @@ -224,11 +224,11 @@

Table of Contents

@@ -237,18 +237,18 @@

I seem to be spending less time working on technical crafts, primarily due to so many other commitments. Making it a goal to remove distractions and focus more on reading, writing and executing.

-
-

Next Week

-
+
+

Next Week

+
-
-

TODO Clean Code Finish

+
+

TODO Clean Code Finish

-
-

TODO Eliminate Distractions

+
+

TODO Eliminate Distractions

-
-

TODO Fix weekly schedule

+
+

TODO Fix weekly schedule

diff --git a/output/blogs/2025/08/what-do-i-want-to-do-with-emacs.html b/output/blogs/2025/08/what-do-i-want-to-do-with-emacs.html index e41b678..aee51bb 100644 --- a/output/blogs/2025/08/what-do-i-want-to-do-with-emacs.html +++ b/output/blogs/2025/08/what-do-i-want-to-do-with-emacs.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + What Do I Want To Do With Emacs @@ -245,7 +245,7 @@ After some thinking I narrowed it down and collated it in the following diagram:

-
+

2025-08-08-emacs.svg

diff --git a/output/blogs/2025/08/zettelkasten.html b/output/blogs/2025/08/zettelkasten.html index bec6508..24a13eb 100644 --- a/output/blogs/2025/08/zettelkasten.html +++ b/output/blogs/2025/08/zettelkasten.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Zettelkasten Method @@ -220,9 +220,9 @@

Zettelkasten Method

education
-
-

The Zettelkasten Method

-
+
+

The Zettelkasten Method

+

This Zettelkasten method is growing in popularity for taking notes. Ever felt as though there's too much pieces of information but you don't know how to deal with it? This method solves exactly that problem and more. Think of it as forming a second brain, where you can jot down ideas and information whilst simultaneously being able to connect them together.

@@ -246,7 +246,7 @@ There are many personal knowledge management systems' (PKMS) out there that allo

-
+

org-roam-ui-graph.png

diff --git a/output/blogs/blogs-intro.html b/output/blogs/blogs-intro.html index 38e95d0..0b3fd90 100644 --- a/output/blogs/blogs-intro.html +++ b/output/blogs/blogs-intro.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Blogs Introduction @@ -220,9 +220,9 @@

Blogs Introduction

introduction
-
-

Introduction

-
+
+

Introduction

+

In this section you will find posts that are not as structured as the ones found in here. Mainly these will deal with findings, research, assorted writings and random bits and blobs.

diff --git a/output/blogs/blogs-list.html b/output/blogs/blogs-list.html index deae0f2..c898323 100644 --- a/output/blogs/blogs-list.html +++ b/output/blogs/blogs-list.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Blogs List @@ -214,17 +214,18 @@
-
Updated: 2025-08-28 Thu 17:03
+
Updated: 2025-08-28 Thu 17:40

Blogs List

See the categories: Categories

-
-

Blogs:

-
+
+

Blogs:

+
-
Updated: 2025-08-28 Thu 17:03
+
Updated: 2025-08-28 Thu 17:40
-
-

Categories (Includes both blogs and posts)

-
+
+

Categories (Includes both blogs and posts)

+
  • books (5)
  • education (1)
  • emacs (2)
    • -
  • insights (3)
    • +
  • insights (4)
  • introduction (2)
  • maths (1)
  • notes (5)
    • diff --git a/output/contact.html b/output/contact.html index 13783c6..12e610e 100644 --- a/output/contact.html +++ b/output/contact.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Contact @@ -218,9 +218,9 @@

Contact

-
-

Contact Using the Following:

-
+
+

Contact Using the Following:

+

> LinkedIn: LinkedIn

diff --git a/output/index.html b/output/index.html index 8811b55..c7d578f 100644 --- a/output/index.html +++ b/output/index.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Home Page @@ -221,15 +221,15 @@

Table of Contents

-
-

Welcome! 🌱

-
+
+

Welcome! 🌱

+

This is a website built using Emacs Org-mode and published using org-publish. The very first iteration of this website used the Angular framework, only after a while I realised (as every Emacs lover does) that I want to make this an Emacs-centric project

@@ -247,9 +247,9 @@ Feel free to explore:
-
-

How to publish web pages using org-publish

-
+
+

How to publish web pages using org-publish

+

This website is heavily inspired by some people who have decided to use org-publish as a way to convert org files into html. I came across a few that took the plunge and decided to migrate from platforms like Wordpress and instead opted for a more transparent, text-based workflow.

@@ -346,9 +346,9 @@ And there we go! The files are now being hosted on http://localhost:8000/<

-
-

Contact

-
+
+

Contact

+

Feel free to reach out on GitHub: https://github.com/zainezq

diff --git a/output/posts.html b/output/posts.html index b8b8de5..b6ead60 100644 --- a/output/posts.html +++ b/output/posts.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Posts @@ -218,18 +218,18 @@

Posts

-
-

Links

-
+
+

Links

+
-
-

Posts Introduction   intro

+
+

Posts Introduction   intro

-
-

Zettelkasten Method   education

-
+
+

Zettelkasten Method   education

+

<2025-08-06 Wed>

diff --git a/output/posts/clean-code/clean-code-chapter-1.html b/output/posts/clean-code/clean-code-chapter-1.html index 16e420c..3aec5f1 100644 --- a/output/posts/clean-code/clean-code-chapter-1.html +++ b/output/posts/clean-code/clean-code-chapter-1.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Clean Code: Chapter 1 Notes @@ -224,16 +224,16 @@

Table of Contents

Link to Chapter 2

-
-

Chapter 1: Clean Code

-
+
+

Chapter 1: Clean Code

+

Referenced Items:

diff --git a/output/posts/clean-code/clean-code-chapter-2.html b/output/posts/clean-code/clean-code-chapter-2.html index bd30845..389c686 100644 --- a/output/posts/clean-code/clean-code-chapter-2.html +++ b/output/posts/clean-code/clean-code-chapter-2.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Clean Code: Chapter 2 Notes @@ -224,22 +224,22 @@

Table of Contents

@@ -248,13 +248,13 @@

Link to Chapter 1 | Link to Chapter 3

-
-

Chapter 2: Meaningful Names

-
+
+

Chapter 2: Meaningful Names

+
-
-

Use intention revealing names:

-
+
+

Use intention revealing names:

+

Names should reveal intent, there is no revelation in naming an integer d, intending it stands for days. Instead, you should use the following names:

@@ -267,17 +267,17 @@ Names should reveal intent, there is no revelation in naming an integer d<
-
-

Avoid disinformation

-
+
+

Avoid disinformation

+

Don't postfix the word 'list' to the name 'accounts' unless it's actually a list. This is because the reader will assume the data type of accountsList is indeed a list, instead choose a name like accountsGroup.

-
-

Make Meaningful Distinctions

-
+
+

Make Meaningful Distinctions

+

While it is possible to name by being disinformative, it is also possible to name being non informative. Consider:

@@ -302,18 +302,18 @@ Furthermore, noise words are redundant. We should never use the word varia

-
-

Use Pronouncable Names

-
+
+

Use Pronouncable Names

+

This is quite straightforward. Do not use a name like genymdhms to refer to generation date, year, month, day, hour, minute, and second. Instead use generationTimeStamp.

-
-

Use Searchable Names

-
+
+

Use Searchable Names

+

In modern IDE's, it is still quite difficult to search for single-lettered variables. The writer states a personal preference of using single-letter names only as local variables and inside short methods. The following principle is given:

@@ -323,42 +323,42 @@ In modern IDE's, it is still quite difficult to search for single-lettered varia

-
-

Avoid Encodings

-
+
+

Avoid Encodings

+

Don't prefix variables with letters like m_ as was done in the past. Do not type encode as well, an example of this is: PhoneNumber phoneString; we can see the reader being misled into thinking the phone number is a String.

-
-

Avoid Mental Mappings

-
+
+

Avoid Mental Mappings

+

Clarity is king, don't use a name for a variable that only you know what it stands for. For example: using the letter r as the lower-cased version of the url with the host and scheme removed. That's being smart, not professional.

-
-

Class Names

-
+
+

Class Names

+

Classes and objects should have noun or noun phrase names like Customer, WikiPage, Account, and AddressParser. Avoid words like Manager, Processor, Data, or Info in the name of a class. A class name should not be a verb

-
-

Method Names

-
+
+

Method Names

+

Methods should have verb or verb phrase names.

-
-

Don't be cute/Don't use puns

-
+
+

Don't be cute/Don't use puns

+

Do not use names that are only understandable to people whom you share jokes etc with. Furthermore, do not use colloquialism and slang in names.

@@ -368,17 +368,17 @@ Do not use names that are only understandable to people whom you share jokes etc
-
-

Pick one word per concept

-
+
+

Pick one word per concept

+

If you have multiple choices for naming a concept, use one and stick with it. For instance if your options are fetch, get and retrieve, use one and stick with it throughout.

-
-

Solution Domain Names and Problem Domain Names

-
+
+

Solution Domain Names and Problem Domain Names

+

Where possible use solution domain names, as the people that are going to be reading the code are programmers. Therefore, do not shy away from using CS terms, algorithm names, math names and so forth.

@@ -388,17 +388,17 @@ However when it is not possible to use solution domain names (in other words, wh

-
-

Add Meaningful Context

-
+
+

Add Meaningful Context

+

Enclose names with well-named classes, functions, or namespaces. When all else fails, then prefix with something that provides more context.

-
-

Don't add gratuitous context

-
+
+

Don't add gratuitous context

+

Shorter names are better than longer ones, generally. This is so long as the context and intent is clear. Don't add redundant or irrelevant additions to the name in the for the sake of 'context'.

diff --git a/output/posts/clean-code/clean-code-chapter-3.html b/output/posts/clean-code/clean-code-chapter-3.html index 91c25b3..467066e 100644 --- a/output/posts/clean-code/clean-code-chapter-3.html +++ b/output/posts/clean-code/clean-code-chapter-3.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Clean Code: Chapter 3 Notes @@ -224,15 +224,15 @@

Table of Contents

@@ -241,13 +241,13 @@

Link to Chapter 2 | Link to Chapter 4

-
-

Chapter 3: Functions

-
+
+

Chapter 3: Functions

+
-
-

Functions should be small

-
+
+

Functions should be small

+

Functions should be extremely short—ideally just a few lines, so they remain easy to understand and maintain.

@@ -269,9 +269,9 @@ Large functions hide complexity and mix abstraction levels, making errors and du

-
-

Do One Thing & One Level of Abstraction

-
+
+

Do One Thing & One Level of Abstraction

+

A function should do exactly one conceptual task, and all its statements should exist at the same abstraction level.

@@ -293,9 +293,9 @@ Functions that “do one thing” cannot be logically split into sections such a

-
-

Switch Statements

-
+
+

Switch Statements

+

Switch statements naturally violate “do one thing” by handling multiple cases; they also grow in size over time.

@@ -350,9 +350,9 @@ Example:
-
-

Use Descriptive Names

-
+
+

Use Descriptive Names

+

A function’s name should clearly state its purpose. Long, descriptive names beat short, cryptic ones.

@@ -374,9 +374,9 @@ IDE refactoring tools make renaming safe, encouraging experimentation.

-
-

Function Arguments

-
+
+

Function Arguments

+

The ideal number of arguments for a function is zero (niladic). Next comes one (monadic), followed closely by two (dyadic). Three arguments (triadic) should be avoided where possible. More than three (polyadic) requires very special justification—and then shouldn’t be used anyway.

@@ -402,9 +402,9 @@ Match function/argument names in verb–noun or keyword style (e.g., write

-
-

Have No Side Effects

-
+
+

Have No Side Effects

+

A function should do only what its name promises. Hidden state changes are misleading and dangerous.

@@ -426,9 +426,9 @@ Functions that modify state and return information often cause confusion and sho

-
-

Error Handling

-
+
+

Error Handling

+

Error handling is a single responsibility—separate it from normal logic to keep both paths clear.

diff --git a/output/posts/clean-code/clean-code-chapter-4.html b/output/posts/clean-code/clean-code-chapter-4.html index a4a21e5..f1c79e9 100644 --- a/output/posts/clean-code/clean-code-chapter-4.html +++ b/output/posts/clean-code/clean-code-chapter-4.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Clean Code: Chapter 4 Notes @@ -224,34 +224,34 @@

Table of Contents