Compare commits

...

2 Commits

Author SHA1 Message Date
Charles-Axel Dein
a9c19d57c6 Add configuration complexity 2025-03-21 16:05:55 -04:00
Charles-Axel Dein
925ff21586 Update refactoring 2025-03-16 15:18:13 -04:00

View File

@@ -663,7 +663,7 @@ About senior engineers:
- [How To Write Unmaintainable Code](https://github.com/Droogans/unmaintainable-code/blob/master/README.md)
- [kettanaito/naming-cheatsheet](https://github.com/kettanaito/naming-cheatsheet): : comprehensive language-agnostic guidelines on variables naming. Home of the A/HC/LC pattern.
- 🧰 [Quality Engineering Guides](https://qeunit.com/guides/)
- [Refactoring with Codemods to Automate API Changes](https://martinfowler.com/articles/codemods-api-refactoring.html), martinfowler.com
- [What Makes Code Hard To Read: Visual Patterns of Complexity](https://seeinglogic.com/posts/visual-readability-patterns/)
### Communication
@@ -687,6 +687,9 @@ See also the Writing section
- [Your configs suck? Try a real programming language](https://beepb00p.xyz/configs-suck.html)
- Most modern config formats suck
- Use a real programming language
- [Code rant: The Configuration Complexity Clock](https://mikehadlow.blogspot.com/2012/05/configuration-complexity-clock.html)
- Im not saying that its never appropriate to implement complex configuration, a rules-engine or a DSL, Indeed I would jump at the chance of building a DSL given the right requirements, but I am saying that you should understand the implications and recognise where you are on the clock before you go down that route.
- Initially there was hope that non-technical business users would be able to use the GUI to configure the application, but that turned out to be a false hope; the mapping of business rules into the engine requires a level of expertise that only some members of the development team possess.
### Continuous Integration (CI)
@@ -1679,6 +1682,7 @@ JavaScript is such a pervasive language that it's almost required learning.
- [Tripping over the potholes in too many libraries](https://blog.carlmjohnson.net/post/2020/avoid-dependencies/)
- [Build It Yourself](https://lucumr.pocoo.org/2025/1/24/build-it-yourself/)
- It's 2025 and it's faster for me to have ChatGPT or Cursor whip up a dependency free implementation of these common functions, than it is for me to start figuring out a dependency.
- [Refactoring with Codemods to Automate API Changes](https://martinfowler.com/articles/codemods-api-refactoring.html), martinfowler.com
### Regex