기술 블로그는 어떻게 작성합니까? [닫은]

나는 보통 프로그래밍 관련 것들에 대해 많이 읽습니다. 내가 읽은 주제가 내 작업과 직접 관련이없는 경우 (예 : 일상적인 작업에 사용하지 않는 일부 알고리즘에 대해 읽는 경우) 잊어 버립니다.

배운 내용을 강화하는 한 가지 방법은 블로그를 작성하는 것입니다. 저는 블로그를 쓰는 초보자입니다. 내가 글을 쓰기 시작했을 때 나는 그것이 매우 힘들다는 것을 알았습니다. 단순히 콘텐츠를 재생하는 데 약 2 시간이 걸립니다. 블로그에 대해 잘 생각하려면 하루 종일 또는 때로는 주말이 걸립니다.

이것이 정상입니까? 기술 튜토리얼 / 기술 블로그를 작성하기위한 팁이 있습니까?

글쓰기는 어렵고 글쓰기는 더 어렵습니다. 무언가를 설명하려고하는 것은 더 많은 지식이 필요하다는 것입니다. 나는 블로깅을 통해 1. 이해해야 할 관련 주제를 찾고, 2. 내 이해가 얕은 곳을 식별합니다.

이 슬라이드 ( http://www.ai.uga.edu/mc/WriteThinkLearn.pdf)를 읽으십시오 . 그들은 글쓰기에 대해 많은 것을 설명하고 심지어 프로그래밍과 비교합니다.

모든 품질의 작업에는 시간과 노력이 필요합니다. 예상됩니다.

이전 블로그 글 중 일부를 완성하는 데 약 3 주가 걸렸습니다. 초안을 작성하고, 다시 읽고, 필요한 수정을하고, 다시 스캔 한 다음 교정하십시오. 시간이 걸린다.

동기를 유지하는 방법에 대한 간단한 아이디어. 큰 것을 계획하고 있다면 작품을 2-3 부분으로 나누고 별도로 게시하는 것이 합리적인지 고려하십시오. 부품은 물론 독자에게도 유용 할 필요가 있습니다. 그런 다음 시간이 덜 걸리면 부분적으로 작업을 완료하고 완료 할 가능성이 높아집니다.

이 알려지지 않은 기술 블로거의 팁 :

• 미리보기에서 명령 행 또는 실행할 텍스트 파일로 잘라서 붙여 넣어 입력 한 코드를 확인하십시오 (읽기만이 아님). 편집기 (또는 셸)에서 웹 페이지로 또는 그 뒤로 전송할 때 몇 가지 항목 (줄 끝, 들여 쓰기 및 유니 코드 문자)이 엉망이 될 수 있습니다.
• 오는 Get 인간을 위해 철자, 문법과 내용을 확인 - 그것은 어떤 노력이 기사를 수정하고 쉽게 읽을 제작에 들어간 것을 알 수있다. 아무도 없을 경우 게시하기 전에 전체 기사를 다시 읽으십시오.
• 블로그 플랫폼에 구문 강조 표시 가있는 경우이를 사용하십시오. 그렇지 않은 경우 코드가있는 코드를 게시하고 링크하십시오.
  • Corollary : 기사 텍스트에서 코드 덩어리를 멀리하십시오. 약간 모호하지만 텍스트가 일부 코드의 작동 방식을 설명하는 경우 스 니펫을 포함하는 것이 좋습니다. 다운로드 할 소프트웨어를 제공하는 경우 VCS 웹 인터페이스를 참조하는 것이 좋습니다.
• 모든 기사는 독자적 으로 읽을 수 있어야합니다 . 다른 기사를 참조하는 것은 좋지만 독자가이 게시물 이전에 다른 게시물을 읽었다 고 가정하지 마십시오.
• 이해를 돕기 위해 텍스트 이외의 형식을 사용하십시오 . 어떤 경우에는 코드가 충분하지만 어떤 경우에는 이미지 나 애니메이션이 훨씬 이해하기 쉽습니다.

어려운 블로그 게시물은 조사가 필요하기 때문에 너무 오래 걸리는 경우가 많습니다. 이 연구는 블로그 게시물에 도움이 될뿐만 아니라 그 과정에서 자신의 지식을 쌓는 데 도움이됩니다. 말씀 드린대로 게시물을 작성하여 지식을 강화하고 있습니다. 당신은 또한 당신의 지식을 확장하고 있습니다. 필요한 시간을 포용하고 학습 경험으로 평가하십시오.

그렇습니다. 기술 블로그 작성에 시간이 걸리는 것은 정상 입니다. 나에게 글쓰기는 가장 짧은 시간이 걸립니다 (길이에 따라 한 시간 또는 하루 정도). 그런 다음 편집 및 재 작성은 일반적으로 더 오래 걸립니다 (최대 2 일 또는 3 일). 언급 된 또 다른 측면은 샘플 코드를 명확히하는 것입니다. 또한 주제에 대한 지원 링크를 찾는 데 시간을 보내고 싶습니다. 모두 시간이 걸립니다!

지금 기술 블로그를 작성할 수있을 것 같지만 특정 도메인의 전문가가되면 그렇게하는 것이 좋습니다. 주말을 보내는 데 너무 많은 시간이 걸리지 않습니다. 그것은 모두 주제의 복잡성에 달려 있습니다. 내가 말하는 것은 아이디어의 핵심이 자연스럽게 당신에게 온다는 것입니다. 실행은 더 오래 걸릴 수 있습니다.

사람들은 블로그에서 전문가의 조언을 구하고 있습니다. 그러나 나는 일반적인 의미로 이야기하고 있습니다 .. 나는 당신이 블로그를 작성하는 것을 권장하지 않습니다. 그러나 다음 사항을 명심하십시오.

1. 블로그에서 새로운 내용을 말해야합니다. 데이터를 수집하여 자신의 블로그 에 올리지 마십시오.

2. 자신이하는 말, 즉 경험이 풍부한 결과 또는 고도로 테스트 된 개념이나 직접 경험 한 것들에 충실해야합니다 .

3. 비판을 준비하십시오.

4. 블로그 작성 기술 (정확성, 간결성 등)을 익히 십시오.

5. 쓰기 무언가 때문에 당신이 이 기록 될 shud 생각; 당신이 생각하지 때문에 것이다 읽을 수.

스타일의 요소

기술적 인 글쓰기는 글쓰기와 거의 같은 규칙을 따릅니다. 글쓰기에 관한 책을 한 권만 읽는다면 고전적인 Strunks "The Elements of Style" 이어야합니다 . 그것은 당신의 구성을 향상시킬 것들, 가장 중요한 것 (IMO), "불필요한 단어 생략"의 목록을 통과합니다.

Stephen King의 " On Writing " 도 추천 합니다. 허구의 글쓰기에 대해 더 많은 정보를 제공하지만, 특히 편집 및 글쓰기 과정과 같은 분야에서 야심 찬 작가에게는 많은 보석이 포함되어 있습니다.

기술적 인 글쓰기에 대한 어려운 점은 실제 글이 아니라 글을 쓰는 것에 대한 당신의 생각을 명확하게하는 것입니다. 헷갈 린 생각은 글을 잘못 쓴다. 글을 잘 쓰려면 주제에 대한 명확한 이해가 필요하기 때문에 교습과 글쓰기가 주제를 습득하는 훌륭한 방법입니다.

글쎄, 블로그 게시물을 작성하는 데 많은 시간이 걸립니다. 나는 종종 며칠 동안 글을 쓰거나 몇 주 동안 초안으로 남겨두고 때로는 다시 읽은 다음 여기저기서 수정하고 조정합니다.

시간이 걸리지 만 나중에 부끄러워하지 않는 것을 쓰는 데 드는 비용이라면 가치가 있다고 생각합니다.