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