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