初めに 最近ちょっと技術記事を書く人への批判とその批判をする人たちをたたく、というような場面を目にして、以前から思うところがあったのでこの度自分の考えを記事にしました。 そういう状態を画像にするとこんなイメージです。 この記事で少しでも優しい業界になれたらなと思っています。 結論 簡潔にまとめるなら「書く側は正確に、読む側は寛大に」です。 記事を書く側の心構え 受け取り方は人それぞれなので、100%伝わる、理解できる文章はありません。 ですがそれに近付けることはできます。具体的に 適切なタイトル わかりやすい文章と流れ 正確な情報と言葉 動画、GIF、図を用いた説明 上記を意識すればよいかなと思っています。 ほかに注意すべき点があれば、ぜひコメントください。 読む側の心構え 相手が一所懸命記事を書いたということを忘れないようにしましょう。 また読んだ記事に、何かしらのコメントをするなら次の
![技術記事を書く・読むときの心構え](https://cdn-ak-scissors.b.st-hatena.com/image/square/c94af60bf6088eceb15d226cfc87f0c40c39200e/height=288;version=1;width=512/https%3A%2F%2Fres.cloudinary.com%2Fzenn%2Fimage%2Fupload%2Fs--LCLdU4GP--%2Fc_fit%252Cg_north_west%252Cl_text%3Anotosansjp-medium.otf_55%3A%2525E6%25258A%252580%2525E8%2525A1%252593%2525E8%2525A8%252598%2525E4%2525BA%25258B%2525E3%252582%252592%2525E6%25259B%2525B8%2525E3%252581%25258F%2525E3%252583%2525BB%2525E8%2525AA%2525AD%2525E3%252582%252580%2525E3%252581%2525A8%2525E3%252581%25258D%2525E3%252581%2525AE%2525E5%2525BF%252583%2525E6%2525A7%25258B%2525E3%252581%252588%252Cw_1010%252Cx_90%252Cy_100%2Fg_south_west%252Cl_text%3Anotosansjp-medium.otf_37%3A%2525E3%252582%2525B4%2525E3%252583%2525AA%2525E3%252583%2525A9%252540%2525E6%252599%252582%2525E4%2525BB%2525A3%2525E3%252581%2525AFRust%2525E3%252581%2525A7%2525E3%252581%252599%252Cx_203%252Cy_121%2Fg_south_west%252Ch_90%252Cl_fetch%3AaHR0cHM6Ly9zdG9yYWdlLmdvb2dsZWFwaXMuY29tL3plbm4tdXNlci11cGxvYWQvYXZhdGFyLzdlNGE3Zjg2ODIuanBlZw%3D%3D%252Cr_max%252Cw_90%252Cx_87%252Cy_95%2Fv1627283836%2Fdefault%2Fog-base-w1200-v2.png)