utils-clean-code.md

CLEAN CODE

TABLE OF CONTENTS

• NOTES
• DECLARATIVE VS IMPERATIVE
• BASE
• CHECK
• PHP
• JAVASCRIPT

NOTES

(from https://github.com/avernois/prez-clean_code )
test unitaire (avec 1 test par comportement)
ecrire code lisible (petite function bien nommée + niveau abstraction equivalent)
code reflete le metier (nommage function et variable)
ne pas commenter un mauvais code mais plutot le réecrire
commentaire explique un choix de conception/ une obligation de conception / plus que la fonction réalisee
a.getB().getC().doThing() -> a.doThing() (Loi demeter)
utilisation librairie via une facade (impermeable / lib de mes reves)
principe SOLID
jamais retourner null
if/switch -> polymorphisme

DECLARATIVE VS IMPERATIVE

• Declarative vs imperative, Imperative programming specifies how it is to be done (control flow) whereas declarative programming specifies what is to be done (logic of computation).
  While imperative system gives more control to the user, declarative system makes the repetitive processes better, i.e. easier automation and expansion of systems. declarative! Another definition of declaratve: we declare our logic before hand with everything that it needs to accommodate for the whole life cycle from start to end.

• https://www.educative.io/blog/declarative-vs-imperative-programming

• https://betterprogramming.pub/the-burger-analogy-for-imperative-vs-declarative-styles-of-programming-3caf026fd553

BASE

• https://thinkster.io/
• https://github.com/gothinkster

CHECK

• https://github.com/returntocorp/semgrep
• https://github.com/JuanCrg90/Clean-Code-Notes
• https://github.com/kettanaito/naming-cheatsheet
• https://github.com/kriasoft/Folder-Structure-Conventions

PHP

• https://github.com/railto/realworld-slim

JAVASCRIPT

• https://github.com/leonardomso/33-js-concepts#5--vs--vs-typeof
• https://dev.to/carlillo/clean-code-applied-to-javascript-part-vii-practical-refactoring-example-ceaser-cipher-2397