복붙은 있지만 개발자도, 벼락 성공도 없는 산만한 이야기

복붙 개발자의 벼락 성공기
아이리스 클라슨 지음, 이미령.김태곤 옮김 / 한빛미디어 / 2023년 5월

이 글에는 스포일러가 포함되어 있습니다.

<복붙 개발자의 벼락 성공기> 라는 책의 리뷰로, 한빛미디어의 <나는 리뷰어다> 활동을 위해 책을 제공받아 작성된 서평입니다.

짧은 내용 요약

좋소의 10년차 개발자가 자사 서비스 개선을 위해 학부생 시절에 자기가 만들었던 오픈소스 라이브러리를 썼다. 

그 와중에 고객의 키를 github에 공개로 올렸고, 삭제하면서 서버도 날려먹어서 해고 당해 빌빌 대던 중. 

우연히 만난 이너서클들의 소개로 오픈소스 라이브러리가 인수되어 잘 먹고 잘 산다는 이야기

처음 책 소개를 접했을 땐 힘들게 코딩하던 개발자가 우연히 취미삼아 만든 앱이 대박나서 사업을 하고 

(이런 스토리는 종종 미디어에서 접하기도 한다) 그 속에서 겪는 좌충우돌일 성장기일줄 알았는데 전혀 아니다. 

그 와중에 오픈 소스에 대한 이야기와 로맨스, 그리고 다양성에 대한 이야기도 책에 넣으려다보니 정말 책이 난잡하고 산만하다.

개발용어들이 책에서 꾸준히 등장하는 만큼 개발자 혹은 개발자와 같이 일하지 않았다면 다소 낯설 수 있는 내용들이 있고, 개발자들이 보기엔 주인공은 10년차? 2년차보다도 프로페셔널 하지 않은 개발자로 보인다.

좋은 방향으로 날 놀랍게 한 부분은 번역가 두 분이서 신들린 초월번역으로 이상한 아재 개그까지도 매끄럽게 번역했다는 것과 숨이 턱 막히는 개발팀의 상황을 기가 막힐 정도로 묘사했다는 것.

이 책은 개발자를 대상으로 한 기술서, 소설보단 중고등학생들을 대상으로 한 "개발자 소설"로 포지션을 잡았으면 오히려 좋았을 것 같다.

그러나 여전히 책의 핵심 주제가 뭔지 모르겠다. 

저자가 8번 퇴고 하고 3번 다시 썼다는. 복붙은 있지만 개발자도, 벼락 성공도 없는 신선한 이야기

단단한 문서화를 위한 알찬 가이드 도서

Docs for Developers 기술 문서 작성 완벽 가이드 - 우아한형제들 카카오 등 국내 테크니컬 라이터 11인 인터뷰 특별 수록
자레드 바티 외 지음, 하성창 옮김 / 한빛미디어 / 2023년 4월

문서화

개발자들에게 문서화는 정기적인 운동처럼, 중요하고 필요하지만 없어도 당장은 티가 안나는, 중요하지만 결국 문제가 터지고 나서야 중요성을 알게 되는 그런 오묘한 것이라고 생각합니다.

소프트웨어 개발을 배우는 과정에서 문서화를 자세히 언급하는 곳은 많지 않습니다. 그렇기 때문에, 많은 개발자에게 “기술문서 작성”을 포함한 글쓰기 와 문서화는 익숙하지 않습니다.

뿐만 아니라, 업무를 하는 과정에서도 당장 쌓여있는 task를 처리하는 것이 이미 만들어진, 그리고 언제 다시 바뀔지 모르는 것을 문서화하는 것보다 훨씬 효과적이라고 생각하기 때문에 문서화에 소홀해지기 마련입니다.

시간이 지나면서, 문서화로 인한 장점이 훨씬 더 많다는 것과 이에 대한 체계적인 접근의 필요성을 국내의 기업들도 느끼기 시작했는데요. 이를 전문적으로 하는 Technical Writter, Developer Relation 등의 직군들이 등장하기 시작했습니다.

그럼에도 불구하고 개발자 혹은 개발조직과 연관되어 업무를 하는 사람들은 위의 전문가 그룹 만큼은 아니지만, 기술 문서를 작성하는 방법을 알고 있으면 좋은 것이 많은데요. 오랜만의 완벽 가이드 라는 글자를 제목에 활용한, 그리고 그만한 가치가 있는 멋진 도서가 등장했습니다.

책의 구성과 목차

이 책에서는 기술 문서를 만들기 이전, Cog.ly라는 가상의 api 서비스를 제안하고 이 서비스를 개발 / 사용하는 이해관계자들의 상황을 설명하는 것으로 기술 문서의 필요성을 이야기하는 것으로 시작합니다.

• 이후 (다른 프로덕트들처럼) 문서화를 먼저 계획하고 초안을 만들고, 피드백 하는 과정에서 챙겨야 할 체크리스트들을 자세히 설명하고
• 실행코드나, 이미지 같은 시각화 마지막으로 문서를 어떻게 유지, 배포할 것인지 에 대한 내용을 설명합니다.
• 원서의 저자는 구글, 리눅스 제단, 스트라이프, MS 등의 기업에서 문서화 관련 업무를 하던 분들이었던만큼 많고 자세한 내용을 담고 있으며
• 추가로, 국내 기업의 Technical Writter 들과도 인터뷰를 통해 어떤 역량이 필요한지, 혹은 이 직업으로 어떤 과정들을 거쳤는지 등을 다루고 있습니다.

마지막으로 기술 문서 작성에 관심을 갖는 사람들을 위해 미처 이 도서에 담지 못한 내용들을 레퍼런스로 달아두었기에 학습이나 실습이나 큰 도움이 되리라 생각합니다.

책의 주요 특징

책의 내용은 특정 프로그래밍 언어나 프레임워크가 아닌 가상의 서비스를 전제로 다뤄지고 있습니다.

그래서 이에 대한 제한이 없는 대신, 서비스가 IT 프로덕트가 아니라면 소개하는 원칙들을 서비스에 적용하기 위해 조금 시간이 필요할 수 있습니다.

물론 책의 제목 자체가 “기술문서” 를 가정하고 만들었기 때문에 큰 문제는 아닙니다.

한편 “글쓰기 자체”를 다루기보단, 기술 문서는 어떤 것들로 구성하는 것이 왜 좋은지와 같은, 조금 더 큰 관점에서 설명들이 이루어집니다.

 (가령 아래의 예시에서 글의 문체나, UI / UX 적인 관점에서의 페이지 색상 등은 내용에 비해 상대적으로 중요하지 않습니다)

책은 332페이지로 내용이 꽤 많은 만큼 한번에 다 읽기는 어렵지만, 책에서 장을 넘어갈 때마다 주요 내용들을 “요약” 을 통해 정리 해주기 때문에 처음 읽을 때나, 이후에 실제로 문서를 만들며 읽을 때나 활용할 수 있는 여지가 많이 있습니다.

그래서

• 이 책은 개발자에게 장기적으로 도움이 됩니다.
• 개발 문서를 만들어야 하는 비개발직군에게도 꽤 도움이 됩니다.
• 당연히, Technical Writing 관련 직군으로 커리어를 진행 / 준비하는 하는 사람에게는 즉시 도움이 됩니다.

샘플 코드, 명령어, API 호출을 포함하여 문서에서 제공한 예제들을 테스트하면 정확성 문제를 사전에 해결 하는데 도움이 됩니다.

이 문장에 등장하는 단어들을 바로 이해할 수 있다면 이 책을 이해하는 것은 어렵지 않습니다. 그러나 그렇지 않다면 책의 내용을 이해하기 위해 꽤 많은 시간을 투자해야 합니다.

그럼에도 불구하고, 개발 관련된 업무를 하고 있으며 다른 사람들이 그 개발의 결과물을 활용하는 것이 목적이라면 이 책은 아주 강력한 도움이 될 것이라 생각합니다.

한빛미디어의 <나는 리뷰어다> 활동을 위해 책을 제공받아 작성된 서평입니다.

콘솔 게임 산업의 역사를 공부하는 이유

게임 전쟁 - 게임 패권 다툼 그리고 위대한 콘솔의 탄생
스티븐 켄트 지음, 심백선 옮김 / 한빛미디어 / 2023년 3월

게임 전쟁: 게임 패권 다툼 그리고 위대한 콘솔의 탄생

이번 글은 <게임 전쟁>이라는 책의 리뷰로, 한빛미디어의 나는 리뷰어다 

활동을 위해 책을 제공받아 작성된 서평입니다.

---

갑자기 게임 전쟁

체감상 제 주변은 (온라인과 모바일 게임 유저들이 큰 지분을 차지하긴 하지만) 

본격적으로 게임에 자본을 투자 할 수 있는 시기가 된다면 방 하나에 플스, 엑박, 

닌텐도같은 콘솔과 게임 타이틀들을 구비해두고 게임을 즐기는 로망을 가진 

겜돌이들이 많이 있습니다. (저도 그 중 하나 ㅎㅎ)

저는 몇몇 게임 정도만 즐기는 정도인 라이트 유저이기도 하고, 게임업계 종사자는 

아니기 때문에 게임 개발과정이나, 게임사들의 상황 등은 잘 알지 못합니다. 

마찬가지로 게임의 역사도 아래 음악정도로만 알고 있습니다.

이러한 상황에서 최근, 어마어마한 인공지능들의 등장으로 인해 나타나는 예측들 중 

하나로 아래와 같은 김대식 교수님의 설명이 개인적으로는 꽤 공감가는 관점입니다.

대충 요약하자면 이러합니다.

> 대부분의 노동은 기계로 대체 될 것이며, 인간은 남는 자원을 엔터테인먼트에 쓰게 될 것이다.

이를 반증하듯 물론 여러가지 이유가 있겠지만 몇년전부터, 여러 회사들이 수상할 

정도로 엔터테인먼트로 슬금슬금 영역을 넓히기 시작합니다.

애플, 엔터테인먼트 시장에 진출한다 - 미주 한국일보

김범수의 8조 승부수... 자회사 합쳐 '카카오 엔터'만든다

MS-블리자드 인수, 순조로울까? … 美中 패권 싸움은 새 변수로

이들이 왜 엔터테인먼트, 게임업계에 관심을 갖는 건지를 궁금해하는 것은 확실히 여러가지 

인사이트를 얻을 수 있습니다. 만약 여기서 추가로 그 동안의 전통의 게임업계들은 어떤 일들을 

겪어왔고, 어떤 전략과 판단을 통해 결정을 내렸고 그 결과들은 어땠는지 안다면 상당히 많은 

시행착오를 줄일 수 있지 않을까 생각합니다.

---

이 책의 특징

책의 저자인 스티븐 켄트는 93년부터 비디오 게임을 취재해오던 기자입니다.

그만큼 이 산업에서 많은 사람들을 만나며 역사와 변화를 겪어올 수 있었는데, 

이는 책에서 수많은 게임업계 사람들의 어구와 인터뷰 등을 인용하는 것에서도 드러납니다.

이런 몇몇 “업계사진”이 책의 중간에 있긴 한데 많지는 않습니다.

책의 또 다른 특징으로 엄청 두껍고 (총 600페이지) 일러스트나 이미지가 없이 

거의 대부분의 내용이 상세한 글로 구성되어 있습니다. (체감상 99%)

그래서 역사책처럼 많은 것을 배울 수 있다는 장점도 있지만 동시에 콘솔 게임에 

관심을 별로 갖지 않았던 사람은 이해에 조금 시간이 더 걸릴 수도 있습니다.

책은 18개의 챕터로 나눠지지만, 아래와 같이 크게 볼 수 있습니다.

• 게임 콘솔 기업들의 역사: 플스 2 ~ 엑스박스 360까지 (주로 소니, MS, 닌텐도)
• 액티비전 이야기: 갑자기
• 영화와 게임이 서로 영향을 주는 사례 소개

---

이 책의 권장 독자

이 책은 게임 한판 하듯 가볍게 읽을 수 있는 책은 아닙니다. 그래서 이 책을 읽으면서

생각 났던 "아 이런 관점은 이런 사람들에게 도움 되겠다" 싶은 사람들을 소개합니다.

• 비즈니스 / 전략에 관심 있는 사람
• 역사 덕후
• MS, 소니, 닌텐도 같은 게임회사의 주주 혹은 팬
• 게임 업계의 구성원 중 비개발 직군
• E3 같은 게임 전시회에 게임외적인 목적의 관심이 있는 사람

---

번외

이번에 소개하는 게임 전쟁은 “The Ultimate History of Video Games, Volume 2”라는 영제와 

“게임 패권 다툼 그리고 위대한 콘솔의 탄생” 이라는 부제를 가지고 있습니다.

영제에서 알 수 있듯 1권은 약 20년전 “게임의 시대” 라는 이름으로 출간되었습니다. 

물론 1권의 내용을 알지 못해도 읽는 데는 크게 지장이 없습니다.

다만 이 책은 게임 콘솔 (특히 하드웨어)을 위주로 다루고 있기에 모바일, 

캐주얼 게임이나 게임 IP, 디자인, 게임 개발에 관심을 갖는 분 혹은 

겜돌이들은 같은 한빛미디어의 피 땀 픽셀, 피 땀 리셋을 추천드립니다.

인터넷 서점에서 이 책을 소개하는 이미지 중 일부인데, 보여지는 것과는 다르게 

결코… 쉽게 읽을 수 있는 책은 아닙니다.

추가) 이 책을 읽으면 플스, 엑박, 닌텐도를 사고 싶어집니다 ㅋㅋ

퍼듀 컴공의 순수 파이썬

거니의 문과 감성 실용 파이썬 - 문과생의, 문과생에 의한, 문과생을 위한 실용 파이썬 클래스 (비전공자를 위한 코딩 입문서)
이건희 지음 / 길벗 / 2023년 1월

파이써닉 

정확하진 않지만, 파이썬은 아름다움이라는 특유의 철학을 가지고 있습니다. 

프로그래밍 언어의 아름다움은 뭘까요? 어쨌든 뛰어난 아름다움은 소수가 아닌 많은 사람들에게 공감받는다는 관점에서는 모두가 쉽게 사용하는 것도 하나의 파이썬의 아름다운 특징이 아닐까 생각합니다. 

이 책에서 주로 다루는 업무자동화 역시 파이썬의 주요 사용처 중 하나로 많은 “비개발자”에게 아름다운 도움을 줄 수 있는 분야라고 생각합니다.

책의 저자 

위 이미지처럼 책 표지에는 문과생의, 문과생에 의한, 문과생을 위한 이라는 문구가 적혀 있어서 

처음에는 문과생이 파이썬을 공부했고 그 결과를 공유하는 책이구나라고 생각했지만 

퍼듀 컴공, 서울대 컴공 석사까지 졸업한 경력자 형님입니다. (문과생과는 딱히 관계 없는 듯…?)

이미 파이썬 외에도 많은 프로그래밍 영상을 올린 유튜버이며, 클원에 파이썬 강의를 한번 올리기도 했고 (이 책은 올렸던 파이썬 강의를 기반으로 한 책) 몇가지 웹서비스를 만들기도 한 경력자로써 많은 경험을 가지고 계시지만, 오히려 책은 이를 드러내지 않고 담백하게 비경험자의 눈에서 학습 할 수 있게 저술되어 있습니다.

책의 구조 및 특징 

이 책은 크게 2단계로 구성되어 있습니다. 

파이썬 기초: IDE로 아나콘다와 주피터 랩을 활용한다는 것 외에 담는 내용 자체는 다른 도서나 자료와 크게 다르지 않습니다.

파이썬 자동화: 

워드, 엑셀, 웹:셀레니움 크롤링을 다루고 있으며 자동화를 다뤄본적이 없는 사람의 입장에서 파이썬 라이브러리를 찾는 과정부터 다루는 점은 특히 좋다고 생각합니다. 

그러나 2가지 아쉬운 점을 꼽자면 

1. MS 오피스 외에 구글독스나 구글 시트도 다뤘으면 좋았겠다 하는 생각과, 

2. 크롤링이 얼마나 위험한 기술인지 크게 언급하지 않았다는 것. 

예시에서 중고나라 크롤링 시스템을 소개했는데 크롤링 결과를 지메일까지 연동하는 과정을 알려주는 친절함에는 감탄했지만, 최소한 robots.txt 정도는 언급했어야 하지 않았나 생각합니다.

- github으로 예시 코드를 확인 할 수 있는 것과, 스타일을 구분하기 편한 코드 예시 그리고 중간중간 이해를 돕는 콩트… 또한 비경험자에겐 도움이 될 수 있습니다.

- (엄밀히는 책의 특징은 아니지만) 별도의 github repository를 통해 학습 중 막히는 질문을 올리면 저자가 바로 회신을 주는 점은 마찬가지로 효과적인 학습을 도울 수 있는 방법이라고 생각합니다.

- 책은 23년 1월에 업데이트 된 신작이지만, 책의 토대가 되는 영상은 20년 10월의 커리큘럼을 사용하고 있습니다. 물론 책에서 깊은 부분을 다루지 않기 때문에 큰 차이를 체감하긴 어렵지만, 미리 인지하고 있으면 좋습니다. 

그래서 

저는 이 책을 이런 분들에게 추천하고 싶습니다. 

- Python을 이제 막 배워보고 싶은 사람. (목적이 있으면 더욱 좋지만 없어도 상관은 없음) 혹은 프로그래밍을 이제 막 처음 시작하는 사람. 

- Pandas, Numpy를 위시한 데이터가 아닌 업무 자동화에 관심이 있는 사람 

- 저자의 유튜브를 즐겨보는 사람 

- (클래스 101에 있는) 영상강의보단 책을 통한 학습을 선호하는 사람 (이전에는 각 클래스를 별도로 가격을 매겼던 것 같은데 오늘보니 모든 강의를 구독할 수 있게 요금제를 변경한 것 같음) 

이런 분들에겐 크게 도움되지 않을 수 있습니다. 

- Python을 한번이라도 다뤄본 사람. 

- 데이터 분석을 목적으로 Python을 학습하려는 사람. 

- Python의 기초부터 깊은 디테일까지 학습하고 싶은 사람. (책에서는 완전 기초를 위주로 다룸)

길벗의 개발자 리뷰어 활동을 위해 책을 제공받아 작성된 서평입니다.

사키오카 선배와 함께 하는 리액트 스터디

모던 자바스크립트로 배우는 리액트 입문 - 유데미 리액트 강의 최고 평가를 받은 인기 강사에게 배우는 실전 리액트
자케(오카다 다쿠미) 지음, 김모세 옮김 / 한빛미디어 / 2022년 11월

이번 글은 모던 자바스크립트로 배우는 리액트 입문 이라는 책의 리뷰로, 한빛미디어의 나는 리뷰어다 활동을 위해 책을 제공받아 작성된 서평입니다.

프론트엔드 개발자가 아니더라도, IT업계에서 있다보면 리액트, 뷰, 앵귤러 등의 프레임워크 / 라이브러리를 자주 듣게 됩니다. 각각마다 특징과 장단점이 있지만, 개인적으로는 미국(메타)에서 만들었고, 모바일 프로그래밍(리액트 네이티브)과도 연결 되는 기술 스택으로 리액트에 대해 항상 관심을 두고 있었습니다. (심지어, shiny도 리액트와 연동됨)

기술을 학습하는 최고의 방법은 당연히 공식 문서를 보는 것임을 부정할 수 는 없지만, 여러 이유로 입문자에게는 책이나 강의처럼 전문가에 의해 한번 더 다듬어, 큐레이션 된 지식으로 배우는 것도 나쁘지 않다고 생각합니다.

---

이 책의 저자 

이 책의 저자는 유데미에서 2만명이 넘는 수강생에게 리액트를 강의했던 오카타 타쿠미로, 소개 글에는 SI, 프리랜서라는 정글을 거쳐 회사를 창업한 사람이라고 서술되어 있습니다. 

그러다보니 책의 구성도 저자의 경험치가 쌓인 여러 강의들 중, 입문자를 대상으로한 강의의 내용을 기반으로 제작되어있습니다.

---

책의 구조와 특징

1부: 모던 자바스크립트

2부: 리액트 기초

3부: 최근 리액트 트렌드 (프레임워크 및 최적화 기술 등)

경험상 리액트 강의에서는 리액트를 다루는 경우가 많은데, (사실 맞기도 하고) 저자는 리액트에 전제되는 바닐라 JS 에서의 최근 트렌드를 소개하는 것으로 시작합니다. 

책의 약 1/3 정도를 차지하는 1부를 통해, 화살표 함수나, 분할대입, 스프레드, map filter등의 “모던” 기능들과, 각 기능 별로 사용하는 이유와 방법. 그리고 JS에서 DOM 작업 방법, 모듈과 패키지 관리자 등 연관 개념들을 소개한 다음에 리액트 기본을 소개합니다.

<도와주세요 선배님>

책에서는 기술에만 너무 치중하지 않고, 업무를 하는 과정에서 알아두면 좋은 지식들과 겪게 되는 질문들을 <도와주세요 선배님!> 이라는 내용으로 (…) 전달하기도 합니다.

<에피소드 구성>

책의 구성 중, 각 장을 넘어가면서, 가상의 이야기를 통해 어떤 것을 배웠는지 정리, 혹은 배우게 되고 이것이 왜 필요한 지 설명하는 점은 어떤 것을 왜 학습해야하는지 알지 못하는 입문자에게는 좋은 구성입니다.

<코드 설명>

이 책에서는 다양한 색상을 인쇄에 활용하고 있습니다.

그래서 코드를 따라할때의 어느 부분이 추가 / 변경 되었는 지, 중요한 부분은 어디인지 강조된 부분을 쉽게 알아볼 수 있으며, 개발 프로젝트 진행에서의 폴더 구조 또한 명확하게 설명되어 있고, 중간중간 개념을 설명하기 위한 피규어들도 이해가 쉽도록 구성되어 있습니다. (입문자인 제가 읽었을때 한번에 이해 되는 경우는 많지 않았지만, 대부분 2번 정도 읽고 나면 이 개념이 이 뜻이었구나 하고 이해됩니다)

<22년 11월 1쇄의 최근 트렌드 반영>

책에서는 리액트와 연관되어 있는 더 학습하고 활용해야 할 기술들도 이런 목적에서 이런 기술들이 쓰이고 있다 정도의 톤으로 설명하고 있습니다. 개인적으로는 리액트 입문자가 학습을 마치고도 계속 리액트를 더 잘 사용할 수 있게 하는 로드맵으로 볼 수 있다고도 생각합니다.

<(당연히) github을 통해 프로젝트 코드 제공>

이 링크를 통해 확인 할 수 있습니다.

---

그래서

- (아쉽게도 ?) 만화책은 아니기 때문에 사키오카를 포함한 캐릭터의 활용이 많지는 않습니다

- 입문자를 대상으로 잘 풀어져 쓰여 있기 때문에, 책을 쭉 읽어가는데 크게 어려움은 없고, 개념 중 일부만 중간중간 다시 봐야하는 부분들이 있어 읽는데 일주일 정도 시간이 걸렸습니다.

- 이전에 리뷰했던 (그리고 강추했던) 구글 앱스 스크립트 완벽 가이드에서 번역에 힘써주신 김모세님께서 번역한 도서입니다.

- 만약 자바스크립트만 살짝 알고 있는 상황에서, 리액트라는 프레임워크에 관심을 갖기 시작한 사람, 혹은 다른 뷰나 앵귤러 등의 프레임워크가 익숙한 FE라면, 이 책은 리액트 입문 가이드 북으로 아주 괜찮은 책이라 생각합니다. 그러나 이미 활용중이거나 어느정도 알고 있어 이후 단계를 고려해야 한다면 다른 자료를 활용하는 것이 더 좋을 수 있습니다.