글 작성 가이드
해당 글은 2024-07-04에 수정되었습니다.변
변성윤
글또 운영자 / 데이터 과학자 / 코치
- 글 작성이 익숙하지 않은 분들을 위해 작성한 가이드라인입니다
- 8기 이후엔 글쓰기 세미나를 진행하고 있습니다
- 1,000자 이상 작성하는 것을 목표로 해보세요. 1,000자는 생각보다 많지 않습니다
어떤 글을 작성할지 고민됩니다
- 어떤 글을 작성하기 어려우시면, 우선 회사 업무 혹은 요새 공부하고 있는 내용을 정리하면 어떨까요?
- 그래도 어려운 분들은 아래 카테고리를 참고해보세요 :)
- 단, 누군가가 이 글을 리뷰할 요소가 있을까?란 생각을 가지고 어느정도 내용이 있는 글을 작성해주세요-!
- 예를 들어 단순히 xxxx 에러가 났다. ⇒ 이거 사용하니 고쳤다라는 글보단
- XXX 에러가 났는데, 그 원인은 A인 것 같고, 그 해결책은 여러가지가 있고 그 중 이걸 선택했다. 앞으로 이걸 방지하기 위해 애초에 ~~~ 옵션을 사용하면 좋다. 이런 글!
어떤 글이 좋은 글일까요?
- 좋은 글이라고 하면 참 어렵긴한데.. 저는 보통 아래와 같은 질문을 꼭 합니다
- 좋은 글을 정의하기 위해선 자신만의 기준이 필요합니다. 내가 좋다고 생각하는 좋은 글들을 보면서 해당 글들의 특징을 분석해보세요. 또는 글을 잘 작성한다고 생각하는 분의 블로그를 쭉 보면서 어떤 특징이 있나 기록해보세요
- 그리고 내게 적용할 수 있는 내용이라 생각하면 어떻게 적용할 수 있을까? 고민해보고 글을 작성하면 됩니다
대표적인 글 소재
1. Tutorial / 시리즈
- 한번에 담기 힘든 내용이 있다면 시리즈 or Tutorial로 글을 써보는게 어떠신가요?
- Tutorial / 시리즈를 쓰게되면 자연스럽게 매주 써야할 주제가 생기기 때문에 어떤 글을 써야하는지 걱정은 없어질 거에요
2. 번역
- 여러분이 관심이 있는 프로젝트 및 라이브러리와 관련된 영어 블로그 글이 있다면, 번역하고 다른 분들과 공유해보는 건 어떠신가요?
- 영어로 보기 힘든 내용들을 좀 더 편하게 볼 수 있고, 다른 분들이 해당 프로젝트, 라이브러리에 대한 내용을 좀 더 쉽게 접할 수 있을 것 같아요
- 혹은 영어로 작성된 시리즈 글을 번역하는 것도 가능합니다
- 단, 번역을 할 때는 저자에게 허락을 구해야 하며, 저작권 이슈가 존재할 수 있습니다
3. Error/ Bug/ 이슈 해결 방안
- 개발을 하면서 생겼던 Error, Bug에 대한 해결방안을 작성해보면 어떨까요?
- 가령 IDE 버전 오류(?)라, 라이브러리에 대한 버그 등을 찾아서 어떻게 해결했는지에 대한 내용을 작성하면, 같은 문제를 고민하고 있는 분들에게 큰 도움이 될거에요!
- 너무 단순한 글보단, 깊은 내용을 추가하시면 좋습니다
4. 행사 참여 후기
- 기술적인 내용 보다 조금 쉽게 접근할 수 있습니다
- 파이콘, 오픈소스 세미나 등 행사에 참여했던 후기를 적어보세요!
- 직접 가보지 못한 분들에게는 현장의 분위기, 다음에 참여할 수 있는 계기가 생길 수 있습니다
5. 학습 정리용 글
- 지금 공부하고있는 내용에 대한 정리를 하는 글을 작성해보세요!
- 내가 공부하고 있는 내용을 복습 할 수 있고, 다른 분들에게 동기부여가 될 것입니다
6. 정보 전달 글
- 새로운 정보를 전달하는 내용의 글을 써보는 건 어떠세요?
- 가령 python 버전이 업데이트 되서 나온 새로운 기능
- 특정 라이브러리의 지원이 언제 종료되는지에 대한 내용
7. 프로젝트 글
- 여러분이 현재 진행 중이거나 과거에 진행한 프로젝트 전반적인 내용을 글로 써도 좋아요!
- 프로젝트를 진행하면서 느낀점, 결과, 과정 등을 정리하거나, 사용했던 기술 스택 등을 회고 형식으로 전달해도 좋을 것 같아요
- 이것도 한번에 담긴 내용이라면 시리즈로 쓸 수 있겠죠?
8. 책/ 논문 리뷰
- 기술 서적이나 관련 내용이 있는 책을 읽고 리뷰 해보는건 어떠세요?
- 책에 대한 느낀점, 아쉬웠던 점 등을 작성하면, 책을 읽어보려는 분들에게 참고할 내용이 될 것 같아요
- 머신러닝 분야에서 많이 나오는 논문을 리뷰하는 것도 좋은 방법입니다!
9. 회고/ 일지 글
- 프로젝트 회고, 2020년 상반기 회고 등 여러분이 하고있는 일들에 대한 마지막을 회고로 작성해 마무리 하는건 어떠신가요?
- 프로젝트에 대한 아쉬운점, 잘한점 등을 정리해서 회고로 작성하면서 자신에 대해 생각해볼 수 있는 계기가 될 수 있습니다
- 참고로 글또 처음 시작과 마지막엔 다짐 글, 회고 글을 작성하고 연말이 지나거나 1년의 절반이 지난 경우 회고 글을 제안드리기도 합니다 :)
여러분이 쓰고 싶은 다양한 글 모두 가능합니다!