개발자도 글을 잘 써야 한다고요 7월 우아한테크세미나 정리

인문학적 글쓰기? 기술 글쓰기?

기술 글쓰기란 특정 독자를 대상으로 특정 목적을 갖고 특정 정보를 전달한다.

	인문학적 글쓰기	기술 글쓰기
내용	창의, 상상, 상징	사실
대상	일반인	특정인
형식	자유	표준적, 학문적
구성	자유	순차적

 

1. 글 한 편 완성하기는 원래 어렵다

 

2. 소재 정리하기

모두 쓸거리

• 새 환경 적응기
• 개선 사례
• 시행착오 경험담
• 작업 절차
• 특정 기능 활용법

무엇을 쓸지 생각하기

직접 경험한 것 나의 이야기를 녹이는게 굉장히 중요하다.

주제를 정한다

• 주제는 글감이라고도 하며, 내용, 메시지, 테마 등이 함께 뒤섞인 말이다.

주제를 정하기 위해선

• 작성자와 독자 모두 관심이 있는가
• 충분히 자료를 찾을 수 있는가
• 일정 내에 쓸 수 있는가

소재 모으기

• 외부 자료 조사
• 자료가 반이다
• 메모가 자산이다
• 백마디 말보다 숫자가 효과적이다

소재 정리

• 관련된 정보끼리 그루핑
• 정보 덩어리를 논리적 순서로 나열
• 목차만들기
• 주제 좁히기

3. 대상 독자 정하기

대상 독자에 따라 기술 깊이를 조절해야 하고 구체적으로 대상 독자를 정하고 글을 써야 한다.

나만 읽을 글을 쓸지 독자가 있는 글을 쓸지 선택해야 한다.

• 경력 2~3년의  IT 분야 개발자
• IT 관련 전공 대학원생
• IT 관련 전공 대학생
• 비전공자

4. 초안 작성하기

초안 작성은 어디서부터든 일단 쓴다.

• 직접 경험한 이야기로 주제 좁히기
• ~ 하면서 배운것
• ~분만에 뭘 하고 뭐 하는것
• 개발기
• 개선기
• ~ 했던 이유

TIP

• 문장을 쓴다.
• 문장을 조합해 단락을 만든다
• 단락을 조합해 절을 만든다
• 절을 조합해 장을 만든다
  
  모든 초고는 걸레다 - 헤밍웨이

 

5. 글 고치기

전체 글 쓰는 시간의 40% 정도여야 한다. 

글쓰기의 본질은 고치기이며 어쨌든 쓰고 고쳐야 한다.

1 이제 다 썼다고 생각한다. = 이제부터 시작이구나
2 맞춤법과 띄어쓰기 수정에 가장 집중한다. = 흐름부터 봐야 되는구나 논리부터 봐야 하네
3 쓰자마자 바로 검토한다 = 객관화가 안된다.
4 공개하기 부끄러워서 혼자서만 보고 또 본다 = 나만 봐서는 안 보이니 동료한테도 도움 요청하기
는 안된다.

다른 사람의 글을 평가하기는 생각보다 쉽다 그러나 내가 쓴 글은 평가하기 어렵다
객관화를 위해서 여러 가지 방법을 동원해야 한다.

정리

글쓰기 시작을 위해서는

1. 메모 잘하고
2. 메모를 잘 정리하고
3. 객관적 사실 근거 데이터를 바탕으로
4. 여러 가지 소재 중에 나와 독자들이 원하는 소재를 찾고 
5. 글을 쓸 때 일단 쓰고 
6. 흐름은 나중에 고치기 단계에서 고친다

고치기 단계가 가장 중요한 단계라고 생각하면 된다

평소에 관심사를 잘 메모해두고 이를 바탕으로 소재를 찾아내는게 중요하다(상향식)

메모 작성의 현황

보통 

• 메모를 안함
• 다양한 공간에 메모를 함
  • 메모장, 노션, 구글 문서, 나에게 카톡보내기 등 ==> 3가지 해당
    * 어디에 어떤 내용들을 메모를 했는지 파악 불가

메모가 의미 있으려면?

=> 쉬운 형식으로 반복해서 작성이 가능해야 함
=> 각 메모가 연결 되어 있느지 파악을 할 수 있어야함

 

메모를 효율적으로 관리하고 싶다면 - 제텔카스텐

제텔카스텐 (Zettelkasten)

Zettel : 종이, 쪽지, 메모 + Kasten : 상자, 서랍

관심 분야에 대해 완벽한 문장으로 된 메모를 조금씩 작성해보자!

1. 매일 새롭게 알게 되는 지식을 다른 사람이 읽어도 이해할 수 있게 짧은 메모를 작성해보기
2. 새로 작성된 메모와 기존 메모의 연결고리를 생각해보고 기존 메모와 연결해보기
3. 연결된 메모에서 공통된 소재를 발굴해 보기
4. 특정 소재 관련된 메모가 어느 정도 쌓이면 발굴된 소재로 글을 작성해보기
5. 부족한 부분에 대해서 학습 후 메모를 추가해 글을 보강해보기

제텔카스텐 장점 

1. 단순한 메모방식 : 쉽게 습관을 만들 수 있음
2. 내가  관심 있는 소재가 뭔지 파악할 수 있고, 내 관심사에 집중할 수 있음
3. 새로운 메모가 연결되면서 글을 쓸 수 잇는 다른아이디어가 생겨남

맞춤법 확인 방법

1. 네이버, 다음 맞춤법 검사기 활용, 둘이 다르다.
2. 국립 국어원 상담 채널 활용
   온라인 가나다(korean.go.kr)
   우리말365 카카오톡 친구 추가, 1인 1일 5회로 제한

 

출처

[토크쇼] 개발자도 글을 잘 써야 한다고요?!: 개발자를 위한 글쓰기 코칭의 시간! | 7월 우아한테크세미나[토크쇼] 개발자도 글을 잘 써야 한다고요?!: 개발자를 위한 글쓰기 코칭의 시간! | 7월 우아한테크세미나