ソースコードで議論しよう。日本語で議論するの止めましょう（あるプログラミング技術の議論報告）

あるプログラミング技術に関する議論をしました。　
日本語よりも英語の文献を見る方が確実で無駄な時間を削減できました。
英語の文献でも、ソースコードの部分が役に立ちました。　
ソースコードを書き直して、コンパイルしてコンパイルエラー、警告が出ると議論が楽でした。
結論は、ソースコードで議論しましょうということでした。
参考意見としては、ソースコード以外は、できれば英語で議論して、日本語で議論するのは止めましょうということでした。

# 日本語より英語

ある日本語の技術書で議論しようとしました。　

日本語で書いていることは意味がわからず、英語の原典を読みました。　

英語なら、プログラミング言語に出てくる単語と同じ単語で書いてあり、　
プログラマは日本語を読むより、英語を読んだ方がわかりやすいことを確認しました。

日本人が書いた本で、日本語よりも英語でないと意味がわからないことを経験したことがあります。　

RTL設計スタイルガイド Verilog HDL編(System Verilog対応版）
https://qiita.com/kaizen_nagoya/items/4c02f1575db1f28310a7

今回は、自分が著者に入っている本での出来事でした。　

技術者は日本語の資料はなるべく読まれないことをお勧めします。　
って英語で書いても、誰も読んでくれなく、日本語で書いてます。

この記事自体は、英語で書き直します。　
英語で書いて、英語文化圏で好評を得たら、逆輸入する方が楽だという経験もあります。

日本語で書いた論文が査読通らなければ、英語でIEEEかどこかに出せば、　
通ることがあるかもしれません。これは、日本語、英語の問題だけでなく、　
専門家の総数の問題も含みます。ある技術を世界で数人しか扱っていない場合に、　
日本語が分かる人の確率はゼロに限りなく近いからかもしれません。

日本語が必ず悪いというわけではありません。ごめんなさい。

# 英語よりプログラム　
英語を見ても、わからないことがありました。　

例としてsample code があり、ソースコードで説明すると一瞬で伝わりました。　

プログラミングに関する技術は、ソースコードで議論すれば、時間が短縮できる。　

プログラミングのソースコード以外で議論する人の気持ちがわかっていません。　

# 眺めるよりコンパイル　
プログラミングのソースコードも、眺めてわかった気になって、　
脳内コンパイルだけで議論するのは危険なことがあります。　

その方の脳内コンパイラは、その方に最適化していて、　
その方の考えにとって都合の悪いコンパイルエラー、警告は出されません。　

あるいは、実際のコンパイラでは、エラーも警告も出ないものが、　
その方の脳内コンパイラでは、コンパイルエラーになるか、警告がでているらしいです。　

C言語であれば、gcc, Clang、 visual Cの３種類でコンパイルしてみます。　

少し、プログラムを書き換えて、コンパイルしなおしてみるとわかることがあります。

数種類のコンパイルオプションを試してみるとわかることがあります。　

いろいろな警告、いろいろなコンパイルエラー、傾向が出ることとで確かめることができます。

日本語で議論するのを辞め、英語で議論する時間はほんとに少しにして、主にソースコードで議論し、できればコンパイルしながら議論するとよいかもしれません。　

最低でも、プリプロセッサにかけたり、静的検査をかけて、オプションを変更させながら議論するとよいでしょう。　

あるオープンソースの事業で、アーキテクトがソースコードを配布するたびに、チェッカにかけていました。出た警告に対する対応策を考え、ソースコードを手を加えた方がいいこと、コメントを書いておけばいいこと、逸脱の手続き（コード以外の文書化）をとればいいことにに分けていました。

# まとめに代えて
プログラム初心者が知らなくてもいいこと　
https://qiita.com/kaizen_nagoya/items/3eaeb88e583898b8aae7

Fラン文系によるFラン文系のためのFラン文系プログラマ /「Fラン文系」でも就職(プログラマ)できる５つの道　
https://qiita.com/kaizen_nagoya/items/c72fa39e3191ea0290df

なぜ１０歳でプログラマを目指すとよいか「小学生だった僕がプログラミングを覚えるまでにやったこと」への賛歌。仮説（18） 
https://qiita.com/kaizen_nagoya/items/75b0e6882b1e9c9e58db

CPUの歴史と言語・OS・ネットワーク＜書きかけ＞ 
https://qiita.com/kaizen_nagoya/items/0148d8a07dfea115dbbe

10代、20代にお勧めの資格
https://qiita.com/kaizen_nagoya/items/4e0eb6e5d30c0237469d	

お客様が困られないように資格を取るという視点
https://qiita.com/kaizen_nagoya/items/b096e09cc06b475212f5

「【25卒向け】Qiita Career Meetup for STUDENT」予習の勧め
https://qiita.com/kaizen_nagoya/items/00eadb8a6e738cb6336f

「Qiita Engineer Festa 2023〜私しか得しないニッチな技術でLT〜」題材アンケート
https://qiita.com/kaizen_nagoya/items/97a527f63c94ba305fe4
自己記事一覧

Qiitaの記事に３段階または５段階で到達するための方法
https://qiita.com/kaizen_nagoya/items/6e9298296852325adc5e

物理記事　上位100
https://qiita.com/kaizen_nagoya/items/66e90fe31fbe3facc6ff

量子(0) 計算機, 量子力学
https://qiita.com/kaizen_nagoya/items/1cd954cb0eed92879fd4

言語・文学記事　１００
https://qiita.com/kaizen_nagoya/items/42d58d5ef7fb53c407d6

医工連携関連記事一覧
https://qiita.com/kaizen_nagoya/items/6ab51c12ba51bc260a82

通信記事１００
https://qiita.com/kaizen_nagoya/items/1d67de5e1cd207b05ef7

転職(0)一覧
https://qiita.com/kaizen_nagoya/items/f77520d378d33451d6fe

仮説（0）一覧（目標100現在40）
https://qiita.com/kaizen_nagoya/items/f000506fe1837b3590df

zuo_reve 新人の方によく展開している有益な情報」確認一覧
https://qiita.com/kaizen_nagoya/items/b9380888d1e5a042646b

Qiita(0)Qiita関連記事一覧（自分）
https://qiita.com/kaizen_nagoya/items/58db5fbf036b28e9dfa6

安全（0）安全工学シンポジウムに向けて: 21
https://qiita.com/kaizen_nagoya/items/c5d78f3def8195cb2409

Ethernet 記事一覧　Ethernet(0)
https://qiita.com/kaizen_nagoya/items/88d35e99f74aefc98794

Wireshark 一覧 wireshark(0)、Ethernet(48)
https://qiita.com/kaizen_nagoya/items/fbed841f61875c4731d0

線網（Wi-Fi）空中線(antenna)(0) 記事一覧(118/300目標)
https://qiita.com/kaizen_nagoya/items/5e5464ac2b24bd4cd001

OSEK OS設計の基礎　OSEK(100)
https://qiita.com/kaizen_nagoya/items/7528a22a14242d2d58a3

Error一覧 error(0)
https://qiita.com/kaizen_nagoya/items/48b6cbc8d68eae2c42b8

++ Support(0)　
https://qiita.com/kaizen_nagoya/items/8720d26f762369a80514

Coding(0) Rules, C, Secure, MISRA and so on
https://qiita.com/kaizen_nagoya/items/400725644a8a0e90fbb0

プログラマによる、プログラマのための、統計(0)と確率のプログラミングとその後
https://qiita.com/kaizen_nagoya/items/6e9897eb641268766909

なぜdockerで機械学習するか 書籍・ソース一覧作成中 (目標100)
https://qiita.com/kaizen_nagoya/items/ddd12477544bf5ba85e2

言語処理100本ノックをdockerで。python覚えるのに最適。:10+12
https://qiita.com/kaizen_nagoya/items/7e7eb7c543e0c18438c4

プログラムちょい替え（0）一覧:4件
https://qiita.com/kaizen_nagoya/items/296d87ef4bfd516bc394

Python(0)記事をまとめたい。
https://qiita.com/kaizen_nagoya/items/088c57d70ab6904ebb53

官公庁・学校・公的団体（NPOを含む）システムの課題、官（０）
https://qiita.com/kaizen_nagoya/items/04ee6eaf7ec13d3af4c3

「はじめての」シリーズ　 ベクタージャパン　
https://qiita.com/kaizen_nagoya/items/2e41634f6e21a3cf74eb

AUTOSAR(0)Qiita記事一覧, OSEK(75)
https://qiita.com/kaizen_nagoya/items/89c07961b59a8754c869

プログラマが知っていると良い「公序良俗」
https://qiita.com/kaizen_nagoya/items/9fe7c0dfac2fbd77a945

LaTeX(0) 一覧　
https://qiita.com/kaizen_nagoya/items/e3f7dafacab58c499792

自動制御、制御工学一覧（０）
https://qiita.com/kaizen_nagoya/items/7767a4e19a6ae1479e6b

Rust(0) 一覧　
https://qiita.com/kaizen_nagoya/items/5e8bb080ba6ca0281927

100以上いいねをいただいた記事16選
https://qiita.com/kaizen_nagoya/items/f8d958d9084ffbd15d2a

小川清最終講義、最終講義（再）計画, Ethernet(100) 英語(100) 安全(100)
https://qiita.com/kaizen_nagoya/items/e2df642e3951e35e6a53

＜この記事は個人の過去の経験に基づく個人の感想です。現在所属する組織、業務とは関係がありません。＞
### 文書履歴(document history)
ver. 0.01 初稿 　 20230526
### 最後までおよみいただきありがとうございました。
いいね　💚、フォローをお願いします。
####  Thank you very much for reading to the last sentence.
Please press the like icon 💚　and follow me for your happy life.