Cook Dev jwkim2

기술 블로그에 대하여

현재 카테고리는 저희 팀에서 실제 개발을 해 나가면서 고민하거나 도움이 될 만한 내용들을 정리해 놓을 예정입니다.

기술 블로그를 운영하는 회사들이 많지만 대부분 블로그의 형식으로 운영을 하기 때문에 각 주제에 대해서 단편적인 정보를 얻을 뿐, 전체적인 흐름과 단계별 내용 및 가이드를 보기는 어렵습니다. 이와 같은 이유로 저희는 기존의 블로그 형식이 아닌 가이드 형식의 문서화 도구인 VuePress를 선택하였고 위키와 같은 가이드 형식으로 제작 예정입니다.

문서화라는 것이 개발 외적으로 상당한 시간을 소모합니다. 하지만 대부분의 회사가 그렇듯이 개발 중 문서화만을 위한 시간을 따로 잘 할당 되어지지 않습니다. 아마도 이러한 연유로 대부분의 기술 블로그들이 각각의 독립된 주제로써 단편적인 내용만 다루고 있는 듯 합니다.

그럼에도 불구하고 저희 팀이 가이드식 기술 블로그를 운영하는 이유는,

첫째, 저희가 개발을 하면서 매번 찾아 봐야 하는 수고를 한 곳으로 정리하여 집중하기 위합니다.
둘째, 팀에 새로운 맴버가 팀에 합류하였을 때 팀의 기술 스택과 진행 상황등을 파악하기 편리합니다.
셋째, 퇴사나 팀원의 이동에도 기술 스택이 유지가 됩니다.
넷째, 신입 사원들의 트레이닝 자료로 활용이 가능합니다.

구독시 주의 사항

저희도 마찬가지로 개발 시간을 쪼개 가면서 문서를 작성하고 있고, 현재 블로그를 시작하는 시점에서 블로그에 기술된 모든 내용을 단 두 명이서 개발하고 운영함으로써 부족한 점이 많습니다. 대부분의 문서는 Live 로써 내용이 완전히 정리되지 않거나 실시간으로 수정이 될 수도 있습니다.

불완전하거나 부정확한 정보라도 우선 기입을 목표로 하고 있기 때문에 문서에 신뢰도보다는 참고 용도로 보시는 것이 좋을듯 합니다.

저희는 쿡앱스라는 큰 회사에서, 그 중에서도 아주 작은 규모의 하나의 팀으로써 저희가 하는 내용이 회사의 대표성을 가지고 있지 않습니다. 저희가 개발하거나 시도하고 있는 내용들이 쿡앱스 전체가 그럴 것이다라고 오해는 안해주셨으면 합니다. 이런식으로 개발하는 작은 팀도 있구나라고 바주시면 좋을 것 같습니다.

맺음말

기술 블로그를 통해서 자사의 기술 공유할 수 있게끔 허락해주신 대표님께 감사드리며 모두에게 공개되어 있는 블로그이기 때문에 자사 직원분들 누구라도 보시고 혹시나 공개에 부적절한 내용이 있거나 심각한 오류가 있는 내용은 언제든지 저희 팀으로 문의 주시면 즉각 수정하도록 하겠습니다. 감사합니다.

Last Updated: 3/12/2019, 5:27:26 AM