このガイドは、特にウェブテクノロジーとブログに関するテクニカルライティングに関するアドバイスと洞察をまとめ、経験豊富な専門家や個(gè)人的な経験から描きます。

あなたのトピックの選択：

理想的なトピックは、あなたが情熱を持ち、個(gè)人的に投資しているものです。あなたの熱意は輝きます。 Chris Coyierが賢明にアドバイスしているように、「何かをグーグルで検索したときに見つけたい記事を書いてください?！垢瞍戤?dāng)てベースのライティングは生産的ですが、個(gè)人的な接続は品質(zhì)を高めます。

知識(shí)が新鮮である間に書く：

書くのに最適な時(shí)期は、何か新しいことを?qū)Wんだ直後です。経験はまだ鮮明であり、理解の「前」と「後」を伝えることができます。學(xué)習(xí)プロセスについてクイックメモを書き留めることでさえ、後で価値があります。マヌエル?マツゾビッチが例示しているように、「今日私が學(xué)んだ」（TIL）アプローチを考えてみましょう。

レバレッジ比較：

強(qiáng)力で活用されていない技術(shù)は、新しいテクニックを馴染みのあるテクノロジーと比較することです。レイチェル?アンドリューは、jQueryに精通している人に現(xiàn)代のJavaScriptテクニックを説明し、新しいものと既知のものの間のギャップを埋めることを提案します。このアプローチは、馴染みのない基盤を馴染みのない基盤に結(jié)び付けます。

魅力的な紹介の作成：

一般的な落とし穴は、記事の目的を明確に述べ、ターゲットオーディエンスを早期に明確に述べていないことです。レイチェル?アンドリューは、主題と意図した読者をすぐに明確にする簡(jiǎn)潔な紹介の重要性を強(qiáng)調(diào)しています。ブライアン?リナルディは、よく書かれた入門段落が読者が継続するかどうかを判斷できると付け加えています。

クリアで簡(jiǎn)潔なタイトル：

Erin Kissaneは、Clickbaitよりも明確な明確なタイトルを優(yōu)先する明確で説明的なタイトルを提唱しています。 「GlageQL、Phoenix、およびReactの開始」などの明確なタイトルは、あいまいなClickBaityのものよりもはるかに優(yōu)れています。明確さは、読者の理解とSEOの両方に利益をもたらします。

アウトロの蕓術(shù)：

Ben Halpernは、結(jié)論の段落の重要性を強(qiáng)調(diào)しています。簡(jiǎn)単な要約（「あなたが言ったことを「em」と伝えます」）は効果的ですが、巧妙に作られた結(jié)論はメッセージを補(bǔ)強(qiáng)し、閉鎖を提供します。

スキャン可能性の向上：

ブライアン?リナルディは、読みやすさを向上させるために大きなテキストブロックを分割することの重要性を強(qiáng)調(diào)しています。テクニックには、サブヘディング、リスト、関連する畫像とスクリーンショットの使用、例示的なグラフィック、簡(jiǎn)潔なビデオ、順調(diào)なコードブロック、テーブル、および折りたたみ式セクションを使用します<details>/<summary></summary></details> 。間隔、色、アライメントなどの設(shè)計(jì)要素の戦略的使用は、スキャン可能性をさらに向上させます。

アクティブな音聲と単語(yǔ)の選択：

Katy DecorahとNeal Whitmanは、パッシブ音聲（「リクエストはサーバーによって処理される」）ではなく、Active Voice（「サーバーがリクエストを処理する」）を使用することの重要性を強(qiáng)調(diào)しています。 「Just」のような言葉は避けてください。

トーンと聲の維持：

トーン（あなたが何かを言う方法）は、コンテキストと一致する必要があります。フレンドリーで、権威ある、歓迎的で、感謝の気持ちのトーンは、一般的にテクニカルライティングに適しています。さまざまな狀況のトーンを調(diào)整しても、音聲（あなたの性格）は一貫性を保つ必要があります。

長(zhǎng)さの管理：

テクニカルライティングはしばしば過度の長(zhǎng)さに苦しんでいます。ウェイド?クリステンセンは、冷酷な編集アプローチを推奨しています。過度に短い投稿も問題がありますが、単語(yǔ)數(shù)ではなく、明快さと有用性が主要な焦點(diǎn)である必要があります。長(zhǎng)い投稿をシリーズに分割することは、部品がテーマ的に異なり、自己完結(jié)型である場(chǎng)合にのみ行う必要があります。

作家のブロックを克服する：

恐怖と自己疑念は、技術(shù)的なブログに対する一般的な障壁です。マックスベックは、「準(zhǔn)備ができていない」聲を無視して、本質(zhì)的なポイントがカバーされたらすぐに出版を提案します。ジェレミー?キースは、ドラフトを維持することに反対することを助言します。小さな貢獻(xiàn)でさえも役立つことがあります（Matthias ott）。アリ?スピッテルは、初心者でさえ貴重な視點(diǎn)を持っていると指摘しています。

スタイルと創(chuàng)造性：

Sara Soueidanは、完璧なライティングスタイルは1つもないことを強(qiáng)調(diào)しています。あなた自身になり、明確さを維持しながらあなたの性格を輝かせましょう。注釈付きの會(huì)話やビデオシリーズなど、創(chuàng)造的な形式を試してください。

初心者中心のコンテンツ：

Webには初心者レベルのコンテンツが詰まっていますが、よく書かれた入門書が際立っています。明快さは、すべてのスキルレベルにとって価値があります。

現(xiàn)実世界の例と抽象化：

クリスティーンは、複雑な概念を説明するための現(xiàn)実世界の例の重要性を強(qiáng)調(diào)しています。ただし、明確さを妥協(xié)する例は避けてください。抽象化は、効果的に使用すると強(qiáng)力になります。

ブログの利點(diǎn)：

ブログは、キャリアの見通しを強(qiáng)化し、専門知識(shí)を示し、理解を向上させます。 Khoi Vinhは、ブログを「アンプ」と説明しています。

練習(xí)と改善：

一貫した執(zhí)筆と公開は改善のために重要です。 「ステークスで書く」（作品を公に共有する）が最も効果的な學(xué)習(xí)方法です。

あなたの聲を見つける：

あなたの知識(shí)を共有することから始めます。個(gè)人的な経験を取り入れ、他の人を引用し、研究を?qū)g施することにより、執(zhí)筆を強(qiáng)化します。

ゲストの投稿：

サイトにピッチングする場(chǎng)合は、ガイドラインを注意深く確認(rèn)してください。

便利なツール：

コラボレーションのためのドロップボックスペーパーと校正のための文法は、推奨されるツールです。

以上がテクニカルライティングのアドバイスの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。