명령어 등등/코딩 관련 팁

개발자 블로그 글 팁 소재의식을 갖추자

mcdn 2022. 1. 14. 16:22
반응형

개발자가 글을 쓸 때 적합한 마음가짐 세 가지 

1. 소재 위주의 글쓰기 

2. 자기 수준의 글쓰기 

3. 재미있는 글쓰기 

 

1. 소재 위주의 글쓰기 

보편적인 주제로 많은 사람들이 읽기 원하는 것 보다 자기가 맞닥뜨렸던 상황을 어떻게 해결했는지 담담하게 말하는 글 쓰기 

수필 같은 글이라고 생각하면 된다. 

 

2. 자기 수준으로 글쓰기 

구글 면접 질문에서 8살 조카에게 데이터베이스를 3문장으로 소개하기가 있었다고 한다. 

사람들은 지니, 냉장고, 레고 등 다양한 비유법으로 설명을 했다. 구글 면접 질문으로 쓰일 만큼 개발 용어를 쉽게 설명하는게 ㅇ렵다는 뜻. 

그러니까 기술 블로그를 쓸 때 독자를 생각해서 모든 용어를 설명하려고 하지 말자. 결국 핵심 내용만 쓰고 독자가 공부할 수 있게 길만 터놓는 것이 현명하다. 

 

3. 재미있는 글쓰기

물론 군더더기 없이 깔끔한 설명은 공식문서에서 다 하고 있으므로 

우리는 우리의 경험을 녹여낸 글쓰기를 하면 된다. 

 

https://d2.naver.com/helloworld/1264836

기술 블로그 추천 

 

 

종류별로 글쓰기 목차 

1. 개발기 (저)

직접 경험하고 실험한 과정이나 결과 

개발 과정을 설명할 때는 본문부터 쓰고 그다음 머리말과 마무리 멘트를 작성하는 것이 좋다 

난이도 가장 상! 

 

2. 기술 소개, 용어 분석, 에러 해결방법(술)

분석하고 풀이한 글 

여기서 자기 수준의 글쓰기가 중요해지는 듯. 설명하고자 하는 것에 주목하자. 

 

3. 설치 방법, 튜토리얼, 컨퍼런스 후기, 책 리뷰 (편)

질서가 있는 글 쓰기 

단계를 잘 나눠보자 

 

4. 모음, 팁, 00가지 (집)

한데 모아 정리한 것 

여러 사람의 견해를 모아보거나 자신이 경험에서 터득한 것을 핵심만 정리해서 모아보자 

난이도 가장 하! 

 

 

 

[개발자의 글 쓰기] by 김철수 

 

국문학과 출신 개발자 답게 글에 진심인 책이다. 

생각보다 기술 블로그 팁이 적고 전반적으로 다양한 범위를 넓고 얕게 들여다 보는 것이 특징. 

단락과 단어, 변수명, 오탈자, 제안요청서, 기술블로그, 등등을 다뤘다. 

 

소프트웨어 공학을 들어봤으면 그거의 기초 이론을 다룬다고 생각할 수 있을 것 같다. 

대체로 쉬운 내용이고 뻔하긴 하지만 쏠쏠한 팁이 있으니 읽어볼만하다고 봄. 

 

반응형