구글 엔지니어8 구글 엔지니어는 이렇게 일한다 #12장 단위테스트를 읽고 #12 단위 테스트| 일부 내용첫째, 버그도 없고 자신의 검증 대상과 관련 없는 변경 때문에 실패하는 '깨지기 쉬운' 테스트들이 도사리고 있었습니다. 둘째, 무엇이 잘못되어 실패했는지, 어떻게 고쳐야 하는지를 파악하기 어려운 '불명확한' 테스트들이었습니다. 애초에 무슨 기능을 어떻게 검사하려고 했는지조차 이해하기 쉽지 않았습니다. 책에서는 '깨지기 쉬운 테스트' 와 '불명확한 테스트' 를 예시로 맹목적인 테스트로 인해 발생 할 수 있는 생산성 저하 케이스에 대해 설명해주고 있다. 실제 개발을 진행하며 이런 상황을 빈번히 마주치게 된다. 그럴때마다 어떤것이 올바른 테스트 작성 방향성인지 헷갈릴 경우가 많다. 지금도 일부분에 대해서는 혼동이 오고는 한다. 이건 좀 더 경험 / 역량이 쌓이면 해결될것이라고 생.. 2024. 11. 25. 구글 엔지니어는 이렇게 일한다 #10장 문서자료를 읽고 #10 문서자료| 일부 내용대부분의 엔지니어가 코드를 작성하고, 이용하고, 유지보수하며 토로하는 대표적인 불만이 양질의 문서자료가 부족하다는 점 입니다. 지금까지의 경험에 한해서는 어디를 가서도 문서자료의 부족함이 없다는 이야기는 못들어 봤다. 항상 문서 자료가 부족하다는 이야기 뿐이었다. | 일부 내용구글에서 문서자료를 개선하고자 해본 시도 중 가장 성공적이었던 방법은 문서자료를 코드처럼 취급하여 엔지니어링 워크플로에 통합하는 것이었습니다. 그 결과 엔지니어들이 간단한 문서자료를 작성하고 유지보수하는 일이 한결 수월해졌습니다. swagger, jsdoc, postman, redoc 등 이를 활용할 수 있는 도구들이 많이 다양해졌다.대다수의 사람들이 최소한 API 명세에 한해서는 문서화의 중요성을 인.. 2024. 11. 23. 구글 엔지니어는 이렇게 일한다 #9장 코드 리뷰를 읽고 #9 코드 리뷰| 일부 내용지식과 책임을 '소유권' 이라 부르고, 소유권을 행사하는 사람을 소유자 라고 합니다. 단순히 해당 영역의 소스 코드가 소유자의 것이라는 뜻이 아니라 회사가 추구하는 가치가 지켜지도록 관리한다는 의미의 소유 입니다. '회사가 추구하는 가치가 지켜지도록 관리한다'코드 리뷰를 하면서 이런식으로 방향을 정의한적이 있던가. 단순히 팀의 컨벤션, 회사의 컨벤션, 코드의 효율성 및 가독성만을 탐독하지 않았나 반성하게 된다. | 일부 내용구글은 아무리 작더라도 코드베이스를 수정하는 거의 모든 변경에 코드 리뷰를 요구합니다. 이러한 강제적인 규제는 비용을 유발하고 엔지니어링 속도에도 영향을 줍니다. 코드 베이스에 새로운 코드를 추가하는 속도를 늦추고 필요한 변경을 제때 반영하기 어렵게 할 수도.. 2024. 11. 22. 구글 엔지니어는 이렇게 일한다 #8장 스타일 가이드와 규칙을 읽고 #8 스타일 가이드와 규칙| 일부 내용규칙을 관리하는 목표는 '좋은' 행동을 장려하고 '나쁜' 행동을 억제하기 위함입니다. 좋은 말이다. 하지만, 구성원 전부가 이에 대한 취지를 이해하고 지키고자 노력할때 진정한 효과가 발휘되는것 같다. 프로그래밍 과정에서의 규칙에 있어서도 하나의 예외가 발생하기 시작하면 규칙이 그대로 무너져 지키는 사람만 지키는 유명무실한 규칙이 되는 경우도 보았다. | 일부 내용규칙 모음을 정의할 때 반드시 던져야 하는 질문은 '무슨 규칙이 필요하지?' 가 아니라 '어떤 목표를 이루려 하지?' 입니다. 지금까지 규칙은 '나쁜' 행동을 억제하기 위한 용도 였다. 예를 들면 '지각 하지 마라' 와 같이 말이다. 하지만, 이에 대한 관점을 '어떤 목표를 이루려 하지?' 에 두어보지는 않.. 2024. 11. 19. 이전 1 2 다음 반응형