개발자의 글쓰기4

7장. 기술 블로그 쉽게 쓰고 운영하기

01. 기술 블로그를 쉽게 쓰는 방법 3가지

• 개발자가 기술 블로그를 잘 못 쓰는 이유

주제가 불분명하고, 독자 수준이 천차만별이고, 딱히 주장할 것이 없는 기술 블로그를 써야 할 때는 생각이 정리되지 않고 목차도 못 잡고 한 줄도 못 쓴다.

개발자가 블로그에 글을 쓸 때 개발자에게 적합한 방법 세 가지를 제시한다.

1. 소재 우선 글쓰기
2. 자기 수준 글쓰기
3. 재미있는 글쓰기

• 첫째, 주제 의식을 버리고 소재 의식으로 쓰자

소재 의식은 특정한 대상이나 상황에 대한 자기만의 관점이나 생각이나 해결 방안을 뜻한다.

주제 의식은 많은 사람에게 보편적인 주제를 선택해서 더 많은 사람에게 주제 의식을 퍼뜨리는 것이지만,
소재 의식은 독자와 상관없이 대상이나 상황에 맞닥뜨렸을 때부터 그 대상이나 상황에서 벗어날 때까지 겪은 일을 담담하게 정리해서 애기할 뿐이다.

• 둘째, 독자 수준이 아니라 자기 수준으로 쓰자

기술 블로그를 쓸 때는 독자 수준이 아니라 작성자 수준으로 쓰는 편이 낫다.

개발자가 사용하는 용어는 이미 표준이거나 관습인 경우가 대부분이다.
그래서 개발자가 어려운 용어를 쓴 것이 문제가 아니라,독자가 그 용어를 알지 못한 채 글을 읽거나 이해할 능력이 안 되는 상항이 문제다.

독자가 이해하지 못할 것으로 예상하거나 추가 정보가 필요한 용어에는 링크를 걸어두면 된다.
그래야 개발자도 자기가 쓰려는 글의 본질에 집중할 수 있다.

• 셋째, 재미있게 글쓰자

좋은 기술 블로그는 개발자의 경험에서 우러나오는 내용을 적절한 글쓰기 기교로 녹아낸 것이다.

02. 글의 종류별로 목차 잡는 법 - 저술

• 기술 블로그의 4종류, 저, 술, 편, 집

글의 목차를 잡아 구조화하면, 글쓰기를 부담 없이 시작하고 글을 쉽게 쓰고 빠른 시간에 글을 완료할 수 있다.
구조화 하는 방법은 글의 종류별로 다르므로 저, 술, 편, 집 각각에 해당하는 방법을 알아보자.

1. 저 : 직접 경험하고 실험한 과정이나 결과 - 개발기, 도입기, 적용기
2. 술 : 어떤 것을 분석하여 의미를 풀이하고 해석한 것 - 기술 소개, 용어 분석, 에러 해결 방법 등
3. 편 : 산만하고 복잡한 자료를 편집해 질서를 부여한 것 - 프로그램 설치/설정 방법, 튜토리얼, 세미나 후기, 책 리뷰
4. 집 : 여러 사람의 견해나 흩어진 자료를 한데 모아 정리한 것 - 명령어 모음, 팁, ~ 가지 규칙

• 저 : 개발기는 목차를 잘 잡아서 본문부터 쓰자.

1. 목차를 정한다.

2차원 양방향 개발 경험을 1차원 단방향 목차로 바꿔야 하니 어려울 수 밖에 없다.

성공한 루트와 중간에 실패한 루트를 구별한다.
-> 성공한 루트만 남겨서 최종 루트로 정리하고, 이 것을 기준으로 목차를 잡는다.
-> 실패한 루트는 최종 루트 다음에 문제해결이나 팁으로 정리해 덧붙인다.

2. 머리말부터 쓰지 말고 본문부터 쓰자.

3. 머리말은 맨 마지막에 블로그에 올릴 때 생각나는 대로 간략히 적는 것이 좋다

• 술 : 원전을 비교하고 실험해 풀이해서 쓰자.

본래 내용을 바탕으로 자기 생각이나 분석, 해설을 덧붙이는 방식을 쓰는게 좋다.

03. 글의 종류별로 목차 잡는 법 - 편집

• 편 : 순서를 요약하여 쓰자

시간 순서로 하나씩 나열해 내용을 쓴 다음, 단계로 묶어서 요약하기만 하면 글이 완성된다.

• 집 : 글쓰기가 두렵다면 자료를 모아 핵심을 엮어서 쓰자.

04. 기업의 기술 블로그 운영 팁

• 협업해서 글쓰기, 짝 글쓰기를 해보자.

짝 프로그래밍에서 쓰는 방법을 사용해서 짝 글쓰기를 하면된다.

1. Driver & Navigator : 한명은 글을 쓰고 다른 한 명은 글을 검토하는 방식
2. Coder & Adviser : 한명은 글을 쓰고 다른 한 명은 조언하는 방식
3. Verbalizer & Listener : 글을 쓰고 난 뒤 한 명은 글을 읽고 다른 한명은 귀로 듣는 방식
4. Ping-Pong : 두 명이 번갈아 가면서 글을 쓰는 방식

다음 장은..강의 홍보 내용인듯...