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