テクニカルブログはどのように作成しますか？[閉まっている]

私は通常、プログラミング関連のものについて多くを読みます。私が読んだトピックが私の仕事に直接関連していない場合（日常の仕事では使用しないアルゴリズムについての読書など）、それらを忘れます。

学んだことを強化する1つの方法は、ブログを書くことです。私はブログを書く初心者です。書き始めたとき、私はそれが非常に難しいことがわかりました。単純にコンテンツを再生する場合でも、約2時間かかります。ブログについてよく考えて書くには、多くの場合、丸一日か週末がかかります。

これは正常ですか？技術的なチュートリアル/技術的なブログを書くためのヒントはありますか？

書くのは難しく、良い書き方はさらに難しい。何かを説明しようとすることに関することは、それが「ちょっと知っている」よりも多くの知識を必要とするということです。ブログを書くことで、1。理解する必要がある関連トピックを見つけます。2。理解が浅い場所を特定します

これらのスライドhttp://www.ai.uga.edu/mc/WriteThinkLearn.pdfを読んでください。彼らは書くことについて多くのことを説明します（そしてそれをプログラミングと比較します）

質の高い作業にはすべて時間と労力が必要です。それは予想されることです。

私の古いブログ記事のいくつかは、完了するまでに約3週間かかりました。下書きを書き、それを読み直し、必要な修正を加え、もう一度スキャンしてから校正します。時間がかかる。

自分のやる気を維持する方法の1つの簡単なアイデア。大きなものを計画している場合は、作業を2〜3部に分けて別々に公開するのが理にかなっているかどうかを検討してください。当然のことながら、これらの部分は読者自身にとって有用である必要があります。その後、時間がかからないため、あなたはそれを達成し、部分的な作業を完了させる可能性が高くなります。

この未知のテクニカルブロガーからのヒント：

• プレビューからコマンドラインまたは実行するテキストファイルに切り取って貼り付けることにより、入力したコードを確認するだけではありません。エディター（またはシェル）からWebページに移動して戻ってくるときに、いくつかのこと（行末、インデント、Unicode文字など）が台無しになります。
• 取得人間のために、スペル、文法や内容を確認してもらいう-記事を正しく読みやすくするためにいくらかの努力が払われたことを示しています。誰もいない場合は、公開する前に必ず記事全体を読み直してください。
• ブログプラットフォームに構文の強調表示がある場合は、それを使用します。そうでない場合は、コードをそれがある場所に投稿し、そこにリンクします。
  • 結果：記事のテキストからコードの大きな塊を遠ざけてください。これは少しあいまいですが、テキストがコードの動作を説明している場合、スニペットを含めることは問題ありません。ダウンロードするソフトウェアを提示している場合は、VCS Webインターフェイスを参照することをお勧めします。
• すべての記事はそれ自体で読めるべきですです。他の記事を参照することは問題ありませんが、読者がこの記事の前に他の記事を読んだと仮定するだけではいけません。
• 理解を助ける場合は、テキスト以外の形式を使用します。コードによっては十分な場合もありますが、画像やアニメーションの方がはるかにわかりやすい場合もあります。

難しいブログ投稿は調査が必要なため、非常に時間がかかることがよくあります。その研究はあなたのブログ投稿に役立つだけでなく、その過程であなた自身の個人的な知識を築くのに役立ちます。あなたが言ったように、あなたは投稿を書くことによって知識を強化しています。また、知識を広げています。必要な時間を受け入れ、学習体験として大切にします。

はい、技術ブログの執筆には時間がかかるのが普通です。私にとっては、書くのにかかる時間は最短です（長さに応じて1時間から1日まで）。その後、通常、編集と書き換えに時間がかかります（最大2日または3日もかかります）。時間がかかるもう1つの側面は、サンプルコードを明確にすることです。また、トピックのサポートリンクを見つけるのに時間を費やすのが好きです。それはすべて時間がかかります！

テクニカルブログを今すぐ作成できると思いますが、特定の分野の専門家になったときにそうすることをお勧めします。週末を過ごすことは、それほど多くの時間とは思えません。それはすべてトピックの複雑さに依存します。私が言っていることは、あなたのアイデアの核心が自然にあなたにやってくるということだと思います。

人々はブログで専門家のアドバイスを探しています。初心者の実験ではありません。しかし、私は一般的な意味で話している..私はあなたにブログを書くことを思いとどまらせたくありません。ただし、次のことに注意してください。

1.あなたのブログは何か新しいことを言うべきです。データを収集して自分のブログに掲載するだけではありません

2.あなたが言っていることを絶対に確かめてください。すなわち、強い経験的結果、または高度にテストされた概念、またはあなたが直接経験したものに固執してください。

3.批判に備えましょう。

4.ブログを書くテクニックを学ぶ（正確さ、簡潔さなど）

5.書き込み何かので、あなたはそれが書かれshudと思います。読まれると思うからではありません。

スタイルの要素

テクニカルライティングは、他のライティングとほとんど同じルールに従うと思います。執筆に関する本を1冊しか読まない場合は、古典的なStrunks "The Elements of Style"である必要があります。それはあなたの作文を改善するもののリストを通過します。一番重要なのは（IMO）、「不必要な言葉を省く」です。

また、Stephen Kingの「On Writing」もお勧めします。架空の執筆についての詳細はあるものの、特に編集や執筆のプロセスなどの分野では、作家志望の人にとってはまだ多くの宝石が含まれています。

テクニカルライティングに関する難しいことは、実際のライティングではなく、あなたが書いているものについての考えを明確にすることです。混乱した思考は悪い文章につながります。良い文章を書くには、トピックについて明確に把握する必要があります。そのため、教えることや書くことは、主題を習得するための優れた方法です。

ええ、ブログの投稿を書くのに非常に時間がかかります。私は頻繁にそれらを数日間にわたって書いたり、ドラフト形式で数週間残したり、時々それらをもう一度読んだり、あちこちで修正したり微調整したりします。

それには時間がかかりますが、それが私が後で恥ずかしくない何かを書くための価格であれば、私はそれが価値があると思います。