Engineering Culture
첫 변경으로 검증하는 온보딩 문서, 먼저 지킬 계약을 적어 보기
설치 설명이 길어도 새 동료가 실제 변경을 실행하고 확인하지 못하면 개발 환경을 이해하기 어렵다. 작은 결과를 만드는 경로가 필요하다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
THE BUILDER’S NOTE
Engineering.
01 / INSIDE THE BUILD만들며 배우고, 배운 것을 나눕니다.
더 나은 제품을 향한 개발의 기록.
찾고 있던 이야기
작은 발견부터 깊이 있는 고민까지.
카테고리Engineering Culture
필터 초기화Engineering Culture
완료 조건을 구현 전에 맞추기, 먼저 지킬 계약을 적어 보기
작업이 끝났다는 말이 코드 작성, 테스트 통과, 배포 완료 중 무엇을 뜻하는지 다르면 일정과 기대가 어긋난다. 관찰 가능한 완료 조건을 합의해야 한다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
Engineering Culture
리뷰 의견의 강도를 분명히 표현하기, 먼저 지킬 계약을 적어 보기
수정이 필수인 결함과 개인적인 취향이 같은 어조로 전달되면 작성자가 우선순위를 판단하기 어렵다. 의견의 이유와 강도를 함께 적어야 한다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
Engineering Culture
리뷰할 수 있는 크기로 변경 나누기, 먼저 지킬 계약을 적어 보기
기능 추가와 이름 변경, 포맷 수정이 한 번에 섞이면 리뷰어가 실제 동작 변화를 찾기 어렵다. 변경을 나누는 기준은 파일 수보다 설명 가능한 목적이다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.
Engineering Culture
아키텍처 결정에 당시의 맥락 남기기, 먼저 지킬 계약을 적어 보기
결론만 남은 설계 문서는 시간이 지나면 왜 그런 선택을 했는지 설명하지 못한다. 제약이 달라졌을 때 바꿀 부분과 지킬 부분을 구분할 수 있어야 한다. 동작보다 먼저 정할 기준를 중심으로 작은 예제와 확인 기준을 정리합니다.