Engineering Culture
실행할 수 있는 문서 예제 유지하기, 리뷰에서 함께 확인할 질문
설명과 예제가 서로 어긋나면 처음 사용하는 사람이 어디를 믿어야 할지 알기 어렵다. 예제의 전제와 기대 결과를 함께 관리해야 한다. 코드 밖의 맥락 전달하기를 중심으로 작은 예제와 확인 기준을 정리합니다.
THE BUILDER’S NOTE
Engineering.
01 / INSIDE THE BUILD만들며 배우고, 배운 것을 나눕니다.
더 나은 제품을 향한 개발의 기록.
찾고 있던 이야기
작은 발견부터 깊이 있는 고민까지.
카테고리Engineering Culture
필터 초기화Engineering Culture
구현 모양보다 동작을 지키는 테스트, 리뷰에서 함께 확인할 질문
내부 함수 호출 순서까지 고정한 테스트는 리팩터링마다 깨지지만 실제 오류를 놓칠 수 있다. 어떤 계약을 보호하는지 먼저 분명히 해야 한다. 코드 밖의 맥락 전달하기를 중심으로 작은 예제와 확인 기준을 정리합니다.
Engineering Culture
팀의 용어를 같은 의미로 사용하기, 리뷰에서 함께 확인할 질문
같은 단어를 화면, API, 데이터베이스에서 다르게 쓰면 조건을 잘못 이해하기 쉽다. 특히 상태 이름은 사용자 행동과 연결되어야 한다. 코드 밖의 맥락 전달하기를 중심으로 작은 예제와 확인 기준을 정리합니다.
Engineering Culture
코드 소유권을 연락 가능한 책임으로 보기, 리뷰에서 함께 확인할 질문
담당자가 있다는 사실이 다른 사람의 변경을 막는 경계가 되면 병목이 생긴다. 소유권은 판단과 운영 책임을 찾기 쉽게 만드는 장치여야 한다. 코드 밖의 맥락 전달하기를 중심으로 작은 예제와 확인 기준을 정리합니다.
Engineering Culture
회의 기록을 결정과 행동으로 정리하기, 리뷰에서 함께 확인할 질문
발언을 길게 받아 적어도 무엇을 결정했고 누가 다음 행동을 하는지 찾기 어려울 수 있다. 회의의 결과를 실행 가능한 형태로 남겨야 한다. 코드 밖의 맥락 전달하기를 중심으로 작은 예제와 확인 기준을 정리합니다.
Engineering Culture
추정에 범위와 불확실성 함께 남기기, 리뷰에서 함께 확인할 질문
단일 날짜만 제시하면 조사 결과나 외부 의존성에 따른 변동이 보이지 않는다. 추정은 약속의 숫자보다 현재 알고 있는 조건을 설명해야 한다. 코드 밖의 맥락 전달하기를 중심으로 작은 예제와 확인 기준을 정리합니다.