강의를 전자책으로 옮기며 다시 확인한 세 가지

최근 바이브코딩 입문 강의 28강의 자료를 바탕으로 한국어 전자책을 정리했습니다. 강의에는 설명을 따라갈 화면과 동작이 있지만, 책에서는 독자가 문장과 예시를 보면서 작업을 이어가야 합니다. 같은 내용을 다루더라도 전달하는 순서를 다시 생각해야 했습니다.

이 과정에서 다시 확인한 것은 세 가지였습니다. 책에 맞는 목차, 영상 없이 이해할 수 있는 설명, 그리고 완성 파일의 구조와 화면입니다. 아래 내용은 고객 사례가 아니라 제 강의를 책으로 옮기며 진행한 작업을 정리한 것입니다.

1. 강의 차례를 그대로 책의 목차로 쓰지는 않았습니다

강의 자료는 28강이었지만 책의 전체 목차는 8개 장으로 정리했습니다. 강의 번호를 따라가는 것보다, 독자가 설치와 작업 환경을 준비하고 기본 사용법을 익힌 뒤 결과물을 만들어 보는 흐름으로 읽을 수 있도록 묶는 것이 필요했습니다.

예를 들어 작업 폴더와 파일 위치를 모른 채 결과물을 만드는 단계로 넘어가면, 독자는 AI가 만든 파일이 어디에 저장됐는지부터 막힐 수 있습니다. 도구의 기능을 설명하는 것과 독자가 실제 작업을 이어갈 수 있도록 순서를 잡는 것은 별개의 일이었습니다.

2. 화면을 가리키던 설명은 책 안에서 완결되도록 바꿨습니다

영상에서는 “여기를 눌러 보세요”라는 말과 동시에 화면을 보여줄 수 있습니다. 책에서는 그 문장만 남으면 어디를 찾아야 하는지 알기 어렵습니다. 무엇을 열고, 어떤 내용을 입력하고, 결과가 어떻게 나와야 하는지를 글과 예시 안에서 확인할 수 있어야 합니다.

이번 책도 외부 실습 파일을 받아야만 따라갈 수 있는 구성을 줄이고, 필요한 예시와 참고 내용을 본문·부록 안에 담는 방향으로 정리했습니다. 설치와 사용법을 읽는 독자가 파일을 찾으러 다른 곳으로 이동하기보다, 책 안에서 다음 행동과 확인할 결과를 알 수 있게 하는 것이 목적이었습니다.

원고를 검토할 때는 각 절에서 세 가지를 물어보면 도움이 됩니다. 시작할 때 무엇이 준비돼 있어야 하는가, 독자가 무엇을 하는가, 끝났는지는 무엇을 보고 판단하는가. 이 중 하나가 빠져 있으면 설명을 보완할 지점을 찾기 쉽습니다.

3. 문장 검토와 완성 파일 검수는 따로 했습니다

본문이 완성된 뒤에도 파일 제작 작업은 남았습니다. 실제 출판용 파일의 검수 기록에서는 EPUB 내부 문서의 구조를 읽을 수 있는지, 목차와 본문·이미지 파일의 연결 경로가 맞는지를 확인했습니다. 종이책용 파일은 판형과 페이지 수, 표지·제목·본문의 대표 페이지를 따로 확인했습니다.

이 작업을 하며 중요하게 본 것은 “원고가 맞다”와 “독자가 받는 파일이 맞다”를 구분하는 일이었습니다. 원고에서 제목과 문장이 정상이어도, 출력 파일의 줄바꿈이나 이미지 배치까지 같은 상태라고 가정할 수는 없기 때문입니다.