Engineering Culture
실행할 수 있는 문서 예제 유지하기, 먼저 지킬 계약을 적어 보기
설명과 예제가 서로 어긋나면 처음 사용하는 사람이 어디를 믿어야 할지 알기 어렵다. 예제의 전제와 기대 결과를 함께 관리해야 한다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
만들며 배우고, 배운 것을 나눕니다.
더 나은 제품을 향한 개발의 기록.
작은 발견부터 깊이 있는 고민까지.
설명과 예제가 서로 어긋나면 처음 사용하는 사람이 어디를 믿어야 할지 알기 어렵다. 예제의 전제와 기대 결과를 함께 관리해야 한다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
새 코드와 이전 코드가 잠시 함께 실행되는 배포에서는 한 번에 열을 바꾸기 어렵다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
오래된 산출물이 캐시에서 복원되면 코드가 수정됐는데도 변경이 반영되지 않을 수 있다. 캐시 키는 결과에 영향을 주는 입력을 설명해야 한다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
텍스트 문제에서 복잡한 모델부터 선택하면 데이터와 평가의 기본 문제를 놓치기 쉽다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
내부 함수 호출 순서까지 고정한 테스트는 리팩터링마다 깨지지만 실제 오류를 놓칠 수 있다. 어떤 계약을 보호하는지 먼저 분명히 해야 한다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
작업 시간이 실행 주기를 넘거나 인스턴스가 늘어나면 같은 예약 작업이 동시에 실행될 수 있다. 스케줄러 설정과 작업의 중복 안전성을 함께 다뤄야 한다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.