Zásady I. - Srozumitelnost

  • Základní biblí každého programátora v Javě je kniha Java efektivně, aneb 57 zásad softwarového experta.

  • Primárním cílem je vždy jednoduchý a přehledný kód. Jednoduchost a přehlednost by většinou měla mít přednost před efektivitou.

  • Dodržujeme konvence pro zápis kódu - letitým, ale stále platným dokumentem jsou Code Conventions for the Java(TM) Programming Language.

  • Volíme srozumitelné identifikátory, snažíme se dodržet zavedené konvence - čím častěji a více lidmi je identifikátor používán, tím musí být zřetelnější, co představuje.

  • Snažíme se psát kód tak, aby nebyly potřeba komentáře.