티스토리챌린지21 구글 엔지니어는 이렇게 일한다 #10장 문서자료를 읽고 #10 문서자료| 일부 내용대부분의 엔지니어가 코드를 작성하고, 이용하고, 유지보수하며 토로하는 대표적인 불만이 양질의 문서자료가 부족하다는 점 입니다. 지금까지의 경험에 한해서는 어디를 가서도 문서자료의 부족함이 없다는 이야기는 못들어 봤다. 항상 문서 자료가 부족하다는 이야기 뿐이었다. | 일부 내용구글에서 문서자료를 개선하고자 해본 시도 중 가장 성공적이었던 방법은 문서자료를 코드처럼 취급하여 엔지니어링 워크플로에 통합하는 것이었습니다. 그 결과 엔지니어들이 간단한 문서자료를 작성하고 유지보수하는 일이 한결 수월해졌습니다. swagger, jsdoc, postman, redoc 등 이를 활용할 수 있는 도구들이 많이 다양해졌다.대다수의 사람들이 최소한 API 명세에 한해서는 문서화의 중요성을 인.. 2024. 11. 23. 구글 엔지니어는 이렇게 일한다 #9장 코드 리뷰를 읽고 #9 코드 리뷰| 일부 내용지식과 책임을 '소유권' 이라 부르고, 소유권을 행사하는 사람을 소유자 라고 합니다. 단순히 해당 영역의 소스 코드가 소유자의 것이라는 뜻이 아니라 회사가 추구하는 가치가 지켜지도록 관리한다는 의미의 소유 입니다. '회사가 추구하는 가치가 지켜지도록 관리한다'코드 리뷰를 하면서 이런식으로 방향을 정의한적이 있던가. 단순히 팀의 컨벤션, 회사의 컨벤션, 코드의 효율성 및 가독성만을 탐독하지 않았나 반성하게 된다. | 일부 내용구글은 아무리 작더라도 코드베이스를 수정하는 거의 모든 변경에 코드 리뷰를 요구합니다. 이러한 강제적인 규제는 비용을 유발하고 엔지니어링 속도에도 영향을 줍니다. 코드 베이스에 새로운 코드를 추가하는 속도를 늦추고 필요한 변경을 제때 반영하기 어렵게 할 수도.. 2024. 11. 22. [오픈소스 기여하기] gautamkrishnar/blog-post-workflow 프로젝트에 기여하기 🏃🏻 들어가며오픈소스인 gautamkrishnar/blog-post-workflow 프로젝트에 기여한 과정에 대해서 정리해 보았습니다 :)해당 프로젝트는 profile readme 파일에서 자신의 블로그 rss 를 기반으로 포스팅 목록을 보여주는 workflow 입니다.( profie readme 를 꾸밀때 사용하기 좋습니다. ) ✅ Issue & Pull Request 만들기1) Contribute 하고자 하는 내용을 issue 로 정리하기비교적 간단한 기여인 해당 오픈소스의 workflow 를 사용해 티스토리 블로그의 rss 도 적용할 수 있다는것을 해당 오픈소스의 readme 에 표시하고자 했습니다. 저의 profile readme 에 해당 workflow 를 적용하여 실제로 티스토리 r.. 2024. 11. 21. [Prisma 99% 에러 잡기] P3018 : A migration failed to apply. | 🔍 에러 및 발생 원인 분석1) Error 메시지 2) Error 발생 원인 분석migration filename | 20240211055424_update_room_id_type_to_string_uuid/* Warnings: - The primary key for the `Room` table will be changed. If it partially fails, the table could be left without primary key constraint.*/-- DropForeignKeyALTER TABLE `Invite` DROP FOREIGN KEY `Invite_roomId_fkey`;-- DropForeignKeyALTER TABLE `User` DROP.. 2024. 11. 20. 이전 1 2 3 4 5 6 다음 반응형
