@kazuo_reve 新人の方によく展開している有益な情報
https://qiita.com/kazuo_reve/items/d1a3f0ee48e24bba38f1
で参照・引用しているURLを一つづつ確認してみよう。
確認する視点は３つ。
-
書いた時点と今とで事情が変わっていないか。
-
書き手と、読み手で見えかたが逆の事象はないか。
-
真偽の論理的な書きぶりの事項は、統計的もしくは確率的に扱った方がよくないか。
25 Japan Plain English & Language Consortium， プレイン・ジャパニーズ10のガイドライン
プレイン・ジャパニーズといわなきゃ、いい記事だったかなって思います。
簡単な日本語、やさしい日本語、やまとことばの３つ候補を考えました。
最初は、やまとことばにしてみます。
やまとことばは、中国から漢字、秦音、唐音が入ってきて、日本語が難しくなる前の言葉という意味でここでは使っています。漢字の訓読みに近い感じかなって思うんです。
1. 時
日時が見当たらない。ソースコードを見てみよう。
<meta property="article:modified_time" content="2020-05-22T08:44:24+00:00" />
2020-05-22 初稿なのか、最終編集日なのか。modified timeだから、最終編集日なのだろう。初稿はいつだろう。
2. 場合
10の見出しがある。
- 情報の論理の整理
- 対象読者を想定する
- 重要な情報は文書の先頭に置く
- 長文にせず、短文を用いる
- 否定や二重否定は避ける
- シンプルな単語を使う
- 主語、目的語を省かない
- 能動態を使う
- 動詞を使う
- 読みやすさを考慮して仕上げる
2.1. 情報の論理の整理
図解がいいかも。大切な点は、ポイントと呼ばない方がいいかも。
開米瑞浩 図解: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（18）
論理は情報。論理の整理でいい。これが情報の整理。
2.2. 対象読者を想定する
まず、誰か一人、固有名詞を記載して読者として書き始めてください。
その人に固有な話になったら、より抽象的な表現をまとめに書けばいいかもしれません。
複数人を想定したり、最初に書き終わる前の書いている最中、人を変えると失敗することがあります。
書き終わってから、別の人もわかるように書き足す方が効率的という経験則があります。
対象は読者、読者は対象。
読者を特定する。
2.3. 重要な情報は文書の先頭に置く
これは戦略です。最初に置く戦略は５−６割がいいでしょう。
真ん中に置く戦略が２割くらい、最後に置く戦略が２割くらいと、
書く文章の質、読者の量、読者の層の数などにより、場所を変える方がいいことがあります。
情報は冗長。事でいい。
2.4. 長文にせず、短文を用いる
1文は50文字以内を心がけましょう。
さっき書いた校正が、50文字以上を42文字にしています。やった。褒められた。
結城浩 推敲: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（23）
短文にする。
2.5. 否定や二重否定は避ける
肯定文のほうが文が短くなります。
プログラマが心がけるとよい文章の書き方
で紹介した文章の書き方 山本和彦 (株)インターネットイニシアティブ PDF版
https://www.mew.org/~kazu/material/2008-bunshou.pdf
接続詞「が」を取り上げている。
肯定ぶんにする。
2.6. シンプルな単語を使う
かんたんな単語を使いましょう。「シンプル」のような単語は使わないようにしましょう。
2.7. 主語、目的語を省かない
主語、目的語を書く。
2.8. 能動態を使う
受け身可能自発尊敬のどれかを解釈するのに時間がかかる可能性があります。
2.9. 動詞を使う
動詞を使うか、名詞を使うか、形容詞を使うかは、その人の姿勢によります。
何か差し出がましい人は動詞を使います。考えて欲しい人は名詞を使うかもしれません。
方向を示したい人は形容詞を使う場合があってもいいでしょう。
動詞を使う人は差し出がましいと覚えて置くといいかもしれません。
2.10. 読みやすさを考慮して仕上げる
読みやすくするか、自分で考えるきっかけを与えるかは、文章も目的によります。
読みやすくすればいいという考えは捨てましょう。
何を目指すかを書く。
3. 統計
3.1 やまとことば への変換
やまとことばに変換するソフトで、この文章も、あの文章も変換してみると面白いかもしれない。
英語にするのもよい。仕様記述言語、プログラミング言語で書き直してもいい。
それがデータだ。
3.2 社会調査
社会的な事象では、統計による検証はできないと仮定して考えるとよい。
統計は嘘をつくための道具かもしれないと。
統計の嘘。仮説（127）
社会事象は検証できないかも。仮説（204）
4 まとめに代えて
新人プログラマ応援 - みんなで新人を育てよう！
今、Qiitaでは、「データに関する記事を書こう！」という行事をやっている。
この文章は、テーマ2『データに関する記事を書こう！』参加記事でもあります。
いくつかの事項は、データを取ってから追記できればいいかもしれない。
あるいは、お手持ちのデータがありましたらコメントいただけると幸いです。
自分の頭で考えることが大事というのがまとめかも。
自分の頭で考えるようになるには
「自分の頭で考える」ということ。
4.1 参考文献
@kojimadev 1年以上かけて生産性倍増＋成長し続けるチームになった施策を全部公開
@torifukukaiou【毎日自動更新】新人プログラマ応援 - みんなで新人を育てよう！（2022年04月） LGTMランキング！
@torifukukaiou 【毎日自動更新】データに関する記事を書こう！ LGTMランキング！
@kazuo_reve 「新人の方によく展開している有益な情報」の中で大学時代に得ておけばよかった情報
@kazuo_reve 私が集めた有益な情報・知識のまとめ
@kazuo_reve 私にとって有効だった学び方5選
@kazuo_reve 自分のQiitaの記事を分析してみた
@kazuo_reve 私が効果を確認した「小川メソッド」
@e99h2121 育児していたからこそエンジニアのお仕事に役立ったこと10選
@e99h2121「女性こそエンジニアになるべきだ？」デブサミウーマン登壇記録
@e99h2121 新人さんにすすめる有益なツール達 2022春
@e99h2121 新人さんにすすめる有益な技術書達 2022春
@ohakutsu 新卒1年目のエンジニアがQiitaの速度改善をした話
@ohakutsu 新卒2年目から見た達人プログラマーの振る舞い
4.2 自己参照
ソースコードを読むための技術: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（１）
スペックアウト手法: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（２）
変更の影響範囲を特定: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（３）
質問は恥ではないし役に立つ: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（4）
質問するときのパターン・ランゲージ: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（5）
「できない人」ほど、人に聞けない: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（６）
分からないをすぐ伝える: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（７）
15分ルール: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（８）
検索の仕方: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（９）
エラーメッセージの読み方と対処: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（10）
Google検索のコツ: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（１1）
新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（12）
日報、週報、月報、年報: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（１3）
新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（１4）
分報（分単位報告）: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（15）
分かる: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（16）
わかったつもり: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（17）
開米瑞浩 図解: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（18）
要求仕様: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（19）
SE用語: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（20）
文章の推敲: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（21）
結城浩 数学文章: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（22）
結城浩 推敲: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（23）
あいまい表現: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（24）
やまとことば: 新人プログラマ応援 @kazuo_reve 新人の方によく展開している有益な情報（25）
「@kazuo_reve 新人の方によく展開している有益な情報」はじめ記事を参照して頂いた時にしていること。
@kazuo_reve「「新人の方によく展開している有益な情報」の中で大学時代に得ておけばよかった情報」に付け加える3つのこと。
プログラマにも読んでほしい「QC検定にも役立つ！QCべからず集」
https://qiita.com/kaizen_nagoya/items/d8ada7b7fceafe2e5f0e
５月病にならないで
https://qiita.com/kaizen_nagoya/items/6b9b1f00937cb8b106c9
最後までおよみいただきありがとうございました。
いいね 💚、フォローをお願いします。
Thank you very much for reading to the last sentence.
Please press the like icon 💚 and follow me for your happy life.