Konvence vývoje » Historie » Verze 3
Jan Kebrle, 2017-04-01 13:46
| 1 | 1 | Jan Kebrle | h1. Konvence vývoje |
|---|---|---|---|
| 2 | |||
| 3 | h2. Obecné konvence kódu |
||
| 4 | |||
| 5 | h3. Fylozofie vývoje |
||
| 6 | |||
| 7 | 2 | Jan Kebrle | Při vývoji budou v maximální možné míře použity/vyzkoušeny "best practices" vývoje softwaru (vysoké pokrytí kódu testy, programování proti rozhraní a modularita, použití návrhových vzorů), které s rostoucí velikostí projektu nabývají na důležitosti. Cílem bude psát čistý, co nejjednodušší a nejsrozumitelnější kód. |
| 8 | 1 | Jan Kebrle | |
| 9 | * Kód bude členěn do malých, maximálně nezávislých logických celků (modulů/tříd) zpřístupněných rozhraním (API). |
||
| 10 | |||
| 11 | 2 | Jan Kebrle | * Názvy proměnných/metod/tříd budou voleny s důkladným rozmyslem tak, aby byly maximálně popisné a samovysvětlující. Komentáře budou proto použity pouze v odúvodněných případech (komplikovaná či špatně čitelná funkcionalita, popis rozhraní). |
| 12 | 1 | Jan Kebrle | |
| 13 | 3 | Jan Kebrle | * Nový kód bude podroben code review dalším členem týmu. Tím se docílí dodržování zde uvedených konvencí a zároveď napomůže včasnému odhalení chyb, nesrovnalostí či odchýlení od specifikace. |
| 14 | 1 | Jan Kebrle | |
| 15 | |||
| 16 | h3. Lokalizace kódu a komentářů |
||
| 17 | |||
| 18 | 3 | Jan Kebrle | Veškerý kód (názvy proměnných, tříd, metod...) bude psán v anglickém jazyce, komentáře kódu a popisy commitů budou pro srozumitelnost psány česky. |
| 19 | 1 | Jan Kebrle | |
| 20 | |||
| 21 | 2 | Jan Kebrle | h2. Konvence pro Jazyk java |
| 22 | |||
| 23 | h3. Styl kódu jazyka Java |
||
| 24 | 3 | Jan Kebrle | * Při vývoji budou dodržovány konvence popsané v tomto "dokumentu":http://www.oracle.com/technetwork/java/codeconvtoc-136057.html |