기술 작문에 대한 조언

이 안내서는 기술 작문, 특히 웹 기술 및 블로깅에 대한 조언과 통찰력을 컴파일하며 숙련 된 전문가 및 개인 경험을 바탕으로합니다.

주제 선택 :

이상적인 주제는 당신이 열정적이고 개인적으로 투자 한 주제입니다. 당신의 열정은 빛날 것입니다. Chris Coyier가 현명하게 조언 한 것처럼 : "무언가를봤을 때 찾은 기사를 작성하십시오." 과제 기반 쓰기는 생산적 일 수 있지만 개인적인 연결은 품질을 높입니다.

지식이 신선한 상태에서 작성하십시오.

글을 쓰는 가장 좋은시기는 새로운 것을 배운 직후입니다. 경험은 여전히 ​​생생하므로 이해의 "전"및 "후"를 전달할 수 있습니다. 학습 과정에 대한 빠른 메모를 적어 놓는 것도 나중에 가치가있을 수 있습니다. Manuel Matuzovic이 예시 한 "오늘 배운"(TIL) 접근법을 고려하십시오.

비교 활용 :

강력하고 활용되지 않은 기술은 새로운 기술을 친숙한 기술과 비교하는 것입니다. 레이첼 앤드류 (Rachel Andrew)는 jQuery에 익숙한 사람에게 현대 자바 스크립트 기술을 설명하여 새로운 것과 알려진 것 사이의 격차를 해소 할 것을 제안합니다. 이 접근법은 익숙하지 않은 재단과 연결됩니다.

설득력있는 소개 만들기 :

일반적인 함정은 기사의 목적을 명확하게 진술하지 못하고 잠재 고객을 조기에 대상으로하지 않습니다. 레이첼 앤드류 (Rachel Andrew)는 주제와 의도 된 독자를 즉시 ​​명확하게하는 간결한 소개의 중요성을 강조합니다. Brian Rinaldi는 잘 쓰여진 입문 단락이 독자가 계속하는지 여부를 결정할 수 있다고 덧붙였습니다.

명확하고 간결한 제목 :

Erin Kissane은 명확하고 설명적인 타이틀을 옹호하며 Clickbait보다 명확성을 우선시합니다. "GraphQL, Phoenix 및 React의 시작"과 같은 명확한 제목은 모호한 Clickbaity보다 훨씬 우수합니다. 명확성은 독자 이해와 SEO 모두에게 도움이됩니다.

아웃트로의 예술 :

Ben Halpern은 결론 단락의 중요성을 강조하며, 종종 소개 후 두 번째로 읽은 섹션입니다. 간단한 요약 ( "Em"을 말한 내용 ")이 효과적이지만 잘 만들어진 결론은 메시지를 강화하고 폐쇄를 제공합니다.

스캐닝 향상 :

Brian Rinaldi는 가독성을 향상시키기 위해 큰 텍스트 블록을 분해하는 것이 중요하다고 강조합니다. 기술에는 소제목, 목록, 관련 이미지 및 스크린 샷 사용, 예시적인 그래픽, 간결한 비디오, 잘 형성된 코드 블록, 테이블 및 탁월한 섹션이 <details>/<summary></summary></details> 사용됩니다. <details>/<summary></summary></details> . 간격, 색상 및 정렬과 같은 설계 요소의 전략적 사용은 스캐닝 성을 향상시킵니다.

활성 음성 및 단어 선택 :

Katy Decorah와 Neal Whitman은 수동적 인 음성 대신 활성 음성 ( "서버가 요청 처리")을 사용하는 것의 중요성을 강조합니다 ( "요청은 서버에서 처리됩니다"). "정지"와 같은 단어를 피하고 종종 불필요 할 수 있습니다.

어조와 목소리 유지 :

톤 (당신이 무언가를 말하는 방법)은 컨텍스트와 일치해야합니다. 친절하고 권위 있고 환영하며 감사하는 톤은 일반적으로 기술 작문에 적합합니다. 다른 상황에 대한 톤을 조정하면서도 음성 (성격)은 일관성을 유지해야합니다.

길이 관리 :

기술 작문은 종종 과도한 길이로 고통받습니다. Wade Christensen은 무자비한 편집 방식을 권장합니다. 지나치게 짧은 게시물도 문제가 있지만 명확성과 유용성은 단어 수가 아닌 주요 초점이어야합니다. 긴 게시물을 시리즈로 나누는 것은 부품이 주제별로 뚜렷하고 독립적 인 경우에만 수행해야합니다.

작가의 블록 극복 :

두려움과 자기 의심은 기술 블로깅에 대한 일반적인 장벽입니다. Max Böck은 필수 포인트가 다루 자마자 "준비되지 않은"음성을 무시하고 출판을 제안합니다. 제레미 키이스 (Jeremy Keith)는 초안을 유지하는 것에 대해 조언합니다. 작은 기여조차도 도움이 될 수 있습니다 (Matthias Ott). Ali Spittel은 초보자조차도 귀중한 관점을 가지고 있다고 지적합니다.

스타일과 창의성 :

Sara Soueidan은 완벽한 글쓰기 스타일이 없다고 강조합니다. 명확성을 유지하면서 자신이되어 성격이 빛나게하십시오. 주석이 달린 대화 나 비디오 시리즈와 같은 창의적인 형식으로 실험하십시오.

초보자 중심 컨텐츠 :

웹은 초보자 수준의 컨텐츠로 채워져 있지만 잘 작성된 입문 게시물이 눈에 띄게 될 수 있습니다. 명확성은 모든 기술 수준에 가치가 있습니다.

실제 사례 vs. 추상화 :

Christine은 복잡한 개념을 설명하기 위해 실제 사례의 중요성을 강조합니다. 그러나 명확성을 손상시키는 예를 피하십시오. 효과적으로 사용하면 추상화가 강력 할 수 있습니다.

블로깅의 이점 :

블로깅은 경력 전망을 향상시키고 전문 지식을 보여 주며 이해를 향상시킵니다. Khoi Vinh는 블로깅을 "앰프"라고 설명합니다.

실습 및 개선 :

일관된 글쓰기와 출판은 개선에 중요합니다. "스테이크와 함께 쓰기"(공개적으로 작업 공유)가 가장 효과적인 학습 방법입니다.

목소리 찾기 :

지식을 공유하는 것으로 시작하십시오. 개인적인 경험을 통합하고, 다른 사람을 인용하고, 연구를 수행하여 글쓰기를 향상시킵니다.

게스트 게시 :

사이트에 투구하는 경우 가이드 라인을주의 깊게 검토하십시오.

유용한 도구 :

공동 작업을위한 Dropbox 용지 및 교정 용 문법이 제안 된 도구입니다.

위 내용은 기술 작문에 대한 조언의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!