感謝のプログラミング感謝のプログラミングホームテクノロジーテクニカルライターが書いたプログラミング本やアフィリエイト記事を信用するな2020/01/08SHAREツイートシェアはてブGoogle+PocketLINEスポンサーリンクテクニカルライターが書いたプログラミング本の内容が薄すぎる。どいつもこいつも、ネットに転がっているリファレンスを直訳したような本ばかりを書いて、現場の知見もないし、コードが雑だ。掌田津耶乃さんのように薄い内容のリファレンス本を出しまくり初学者からお金を巻き上げるようなテクニカルライターもいれば、「本気なら一緒に頑張ろう」みたいに励ましながらも内容が薄い大重美幸さんのような方もいる。悪口ばかり言っても仕方がないので、彼らの本の何が悪いかを説明していく。公式サイトのリファレンスの焼き直し「なぜそうなるのか」の説明がない実務経験のないテクニカルライターが書く本の一番の特徴は、「なぜの掘り下げ」が足りないところだ。こんな部品があって、こんな風に書けばこう動きますよ、とサンプルを載せるのはいいが、「なぜその部品を使うのか」「どういう仕組みで動いているのか」の説明が一切ない。書いている本人も理解していないのだと思う。初心者向けにリファレンスを出して、お金儲けがしたいのがミエミエで残念な気持ちになる。いう連中の思惑を見抜けずいちいち本を買ってしまう自分も悪いのだが、彼らもいい加減市場に淘汰されてほしい。変数名がisMyChecked1みたいな適当なものだったり、サンプルが本当に「ただ動かすだけ」になっているものが多い。「とにかく動けばいいでしょ」というスタンスが透けて見えるようだ。適当なサンプルを適当に動かすならネット上のサンプルを触っていればいいのだ。適当なコードを書いて本にするのか。リーダブルコードでも読んでから本を書いてほしい。テクニカルライターなんて仕事をして、まともにコードを書いたことがないから適当なコードしか書けないのだ。3年くらい実務経験を積んでから本を書いてほしい。公式サイトのリファレンスの焼き直しさっさと本を出せばそれだけで価値があるのはわかるが、公式サイトの焼き直しレベルの本を日本語にして書くのはどうなのか。本にするならもう少し著者の経験を織り込んだり、読者がより良い知識を得られるように情報を盛り込むべきではないのか。「ネットにあるようなサンプルがただ動くだけの寄せ集め」で本を出版するのだろうか。最近はプログラミングスクールの記事などもテクニカルライター的な連中が書いた記事で汚染されている。欲しい情報の答えも書かずに、「Pythonとは」みたいなくだらない見出しをつけて、SEOだけ強くして、誰も幸せにしない。テクニカルライターは恥を知った方がいい。読者を幸せにしているかと胸に手を当てて考えてみろ。本当にお前はその作品に誇りを持てているのか?金が入ればいいやと思っていないか?テクニカルライターは誇りを持って仕事をすれば、読者の人生を変えることができる。プログラミングは素晴らしいツールだ。使いこなせば魔法が使えるようになる。そんな魔法を教えるのがテクニカルライターの仕事なのだ。困った人を救える可能性があるのだ。銭ゲバ記事を書き散らしてないで、誇りを持って、日本中の読者を幸せにするために本を書いてほしい。コメントをキャンセルメールアドレスが公開されることはありません。*サイト次回のコメントで使用するためブラウザーに自分の名前、メールアドレス、サイトを保存する。英語が苦手な人がTOEICで700点以上取るための勉強方法1国家公務員1種(総合職)試験は超難関なんかじゃない。900時間〜1000時間の勉強時間を確保できれば、独学・予備校無しで普通に合格できる。views2Subversionでフルバックアップ。dumpをとって、リストアさせるまでの手順。views4bashでカンマ区切りのファイルを読み込み、変数を設定する。views8「ソフトバンクのネットワークが異常に遅い」と感じたときに確認するべきこと。views10JSTLとは何か?JSTLを使ったサンプル。views11C#で文字列に改行を入れたり、定数の宣言をしたり、文字列を数値に変換する。views13Node.jsでファイルを読み込むサンプル。views17文系、プログラミング経験なし、独学で基本情報技術者に合格するための勉強方法と勉強時間のまとめ。views18自分が新人だった頃に知っておきたかったweb.xmlの基礎。views20メールを送信する仕組みとCentOSにsendmailをインストールする手順など。一人でも大丈夫!独学歴20年の私が独学で勉強を続けるコツを教えます。