Clean Code – gyakorlati útmutató

A szoftverfejlesztés nem csupán arról szól, hogy a kód működjön. A valódi szakértelem abban rejlik, hogy mások – és a jövőbeli önmagunk – is megértsék, fenntartsák és továbbfejlesszék azt, amit írtunk. Robert C. Martin, ismertebb nevén „Uncle Bob" Clean Code könyvében összegyűjtötte azokat az elveket és gyakorlatokat, amelyek elválasztják a jó kódot a rossztól.

Ez a szekció egy gyakorlatias, fejlesztői szemléletű referencia, amelyet érdemes a mindennapi munkád során kézközelben tartani – legyen szó code review-ról, refaktorálásról vagy egy új feature megírásáról.

Kiknek szól? Minden fejlesztőnek, aki túl akar lépni a „működik, hát jó lesz" mentalitáson – legyen junior, mid-level vagy senior szinten.

---

Mit találsz a Clean Code szekcióban?

1. Bevezetés (/docs/clean-code/intro)
   Mit jelent a tiszta kód, miben más, mint a „spagetti kód".

2. Miért fontos (/docs/clean-code/why-clean-code)
   Technikai adósság, üzleti érvek a tiszta kód mellett.

3. Elnevezés (/docs/clean-code/naming)
   Jó nevek, rövidítések kerülése, boolean nevek, félrevezető elnevezések.

4. Függvények (/docs/clean-code/functions)
   Egy felelősség elve, rövid függvények, kevés paraméter, mellékhatások kezelése.

5. Kommentek (/docs/clean-code/comments)
   Mikor felesleges, mikor hasznos, miértet leíró kommentek, TODO-k, kikommentezett kód.

6. Formázás és olvashatóság (/docs/clean-code/formatting)
   Vertikális és horizontális elrendezés, konzisztens formázás, linterek szerepe.

7. Hibakezelés (/docs/clean-code/error-handling)
   Kivételek vs. hibakódok, hibák elnyelésének elkerülése, saját hibaosztályok.

8. Osztályok és struktúra (/docs/clean-code/classes-structure)
   Single Responsibility Principle, „God Object" elkerülése, kis, fókuszált osztályok.

9. Tesztelhetőség (/docs/clean-code/testing)
   FIRST elvek, pure function szemlélet, dependency injection a tesztelhetőségért.

10. Gyakori rossz minták (/docs/clean-code/bad-patterns)
    DRY megsértése, KISS figyelmen kívül hagyása, magic numbers, mély if láncok.

11. Best practice-ek (/docs/clean-code/best-practices)
    Leíró köztes változók, immutabilitás, stratégia minták, folyamatos refaktorálás.

12. Összefoglalás (/docs/clean-code/summary)
    A legfontosabb Clean Code elvek tömör táblázatos áttekintése és továbblépési javaslatok.