For the love of God
For the love of all you hold good and dear
Document your code
Discussion
What does it mean to document your code?
Ouch. 😂
After you are done writing code you do a find and replace for all of your variables, and you change them to random hashes
nostr:nprofile1qqsza7flq8xjfylqgg66dwrmzrfuff6w9flt0s72795zdrm27ue3fdgpp4mhxue69uhkummn9ekx7mqpzamhxue69uhkzapwdehhxarjwahhy6mn9e3k7mgpzemhxue69uhky6t5vdhkjmn9wgh8xmmrd9skcf3ywc0 wrote a book: Clean Code. Best book on code documentation out there.
Or, at least make the code really self-explanatory. Some of y'all be naming variables a, b, c...
Or just a few comment lines to explain the general idea.
I feel like I have to conjure the spirit of past developers just to understand a few lines of code.
You get something like:
self.config = _config.raw_config
self.config.include = _config.include
And zero explanation for what this “config” is supposed to do.
Working with assembly was easier.
It is a little appreciated fact that the size of the alphabet is a hard limit on the total complexity of a program. The variable z being traditionally used to hold an array of pointers to values that no longer fit in the namespace.
The nice thing about utf-8 is that we can have more than 26 variables by introducing Greek letters.