Зараз я проходжу стажування у великій корпорації, і вони зазнають багатьох змін у структурі доставки програмного забезпечення (переїзд до Agile).
За останні кілька місяців я помітив цю релігійну прихильність до Clean Code
практик, і книга була як біблія для розробників.
Тепер одна з найважливіших особливостей чистого коду - це сам пояснювальний код, який ґрунтується на зрозумілій іменуванні та суворій ре-факторингу. За цим слідує no commenting
правило.
Я розумію, що цей чистий код - це довгострокова інвестиція, яка полегшить наступне обслуговування та вдосконалення коду, але ... чи справді варто цього суєти?
Чи хтось поділиться своїм досвідом роботи щодо чистого кодексу та будь-якої думки, чи я занадто консервативний, чи це лише тимчасова тенденція.
CalculateFoonicityMetric()
говорить вам саме про те, що він робить, і добре написаний код покаже вам, як ... але жоден з них не скаже вам, чому . Код може бути очевидним у чому (помножте це на те, поділіть на інше, покладіть його на квадрат, додайте цей біт ...), але незрозуміло, чому (коефіцієнт = a * b / c; для дрейфу ...). Я вдячний за короткий коментар, який пояснює, чому.