기술 블로그, 잘 쓰는 방법이 있을까?

 기술 블로그, 잘 쓰는 방법이 있을까?

안녕하세요! 이번 글에서는 기술 블로그 글쓰기와 관련된 강의를 듣고, socode님의 경험과 생각을 녹여 공유해보려고 합니다.

예상 독자

1. 기술 블로그 글을 쓰는 것이 어려운 분

2. 체계적인 글 작성을 하고 싶은 분 (파이프라인)

 대체 어떤 글이 좋은 글이야?

저는 글또라는 글쓰는 개발자 커뮤니티 활동을 시작한 초기에 "좋은 글이란 무엇일까?"라는 생각을 많이 했습니다.

그전까지는 다른 블로그에서 좋아 보이는 점들을 생각 없이 따라 하기만 했지, 글쓰기에 대한 본질적인 고민을 깊게 해본 적은 없었습니다. 아마도 "내 글은 어차피 많이 안 볼 거야"라는 생각으로 블로그를 작성했던 게 이유가 아니었나 싶습니다. 😅

고민은 시작했지만, 평소에 막연히 "사람들이 쉽게 읽을 수 있는 글을 쓰자"라고만 생각했기 때문에 갈피를 잡지 못하고 시간이 많이 흘렀습니다. 그러던 중 카일 스쿨의 글쓰기 강의를 듣게 되었고, 여러 가지 고민이 한층 해결되었습니다.

내가 생각하는 글쓰기의 주요 어려움과 해결 방안

1.  글이 만족스럽지 않음

: 내가 좋다고 생각하는 글의 특징을 찾아 기준을 정해보기

2.  소재가 안 떠오름

  • 일상에서 틈틈이 생각해보고 메모하기
  • 회사에서 사용하는 기술을 내 식으로 가공해서 글에 활용하기
  • 당장 쓰고 싶은 주제는 바로 글로 쓰기

3.  타인에 대한 의식

: 눈치 보지 말자. 생각보다 사람들은 내 글에 큰 관심이 없다...!

내가 좋다고 생각한 글들의 특징을 적어보자!!

1. 개념 관련 글

  • 왜 이 개념을 소개하는지/ 주로 어디에 사용되는지 제시
  • 설명 및 특징 : 코드 예시, 도표, 이미지 적극 활용
  • 활용한 프로젝트
  • 개념 정리하면서 느낀 점

2. 오류 관련 글

  • 왜 문제가 생겼는지에대한 설명
  • 해결 방법 여러가지 2~3개 중 1개 선택: 왜 선택했는지 설명 필요
  • 특정 문제의 중요성
  • 오류 해결하면서 느낀 점

3. 기술/ 기능 관련 글

  • 기능이 어떤 부분에서 사용되는지 왜 다루게 됐는지 설명
  • Document에서 해당 함수/기능 정의 설명(보통 사용 방법을 정확히 알려줌).
  • 위 내용을 직접 활용해서 적용해보기
  • 적용해보면서 느낀 점

나만의 글쓰기 파이프라인

  1. 소재 저장: 일상에서 메모하기
  2. 공부: 주제와 관련된 자료 조사
  3. 초안 작성: 제한 시간 내에 빠르게 초안 쓰기
  4. AI 피드백: LLM 서비스로 수정 및 보완
  5. 블로그 업로드: 초안 정리 및 게시
  6. 퇴고/피드백: 댓글과 반응을 통해 개선 
  7. 기술 블로그, 잘 쓰는 방법이 있을까?

瓢蟲

不朽의 古典에서 찾은 智慧와 心灵, 역사적 敎訓과 省察에서 옛글의 향기에 취해 사랑에 빠지게 되었음을 밝히는바이다

댓글 쓰기

다음 이전