Qiita などの技術系の記事で残念に思うポイント - Qiita

Qiita などの技術系の記事を読んでて「あ，ココちょっと残念」と思うポイントを書いてみます。自らの反省も込めて。 日本語表現・表記 「値を返却する」という表現 関数やメソッドが値を return することを日本語で「返却する」と表現した記事がたくさんありますが，ものすごい違和感を覚えます。 「値を返す」と書くべきでしょう。 この件は以前書きましたので理由はそちらを見てください。 「値を返却する」って言うな 「可変する」という言葉 「可変する」というおかしな言葉もよく目にします。 「可変」というのは，読んで字のごとく「変わりうる」とか「変えうる」という意味です。英語でいうと variable（vary しうる）ですね。 「PNG の圧縮方式は可逆だ（逆変換が可能だ）」というときの「可逆」と同様の成り立ちなわけです。 可変長配列と言えば，固定長ではなくて，あとから伸ばしたりできるような配列の

[naokun776]

"40 年以上地球に住んでいますが"/地球外に住んでいた時期の話が聞きたい

[tsucchi1022]

めっちゃいいこと書いてあるのに、この記事自体が「タイトルで中身が十分に分からない」のアンチパターン踏んでる気がする。

[gfx]

タイトルだけ読んでスルーするところだったけど、要はエンジニアのための人に読んでもらう文章術。

[murasaki11]

主語が無駄に大きい、がない…

[mh615033891]

もわもわ（CIツールで推敲して自動で編集リクエストを投げるとこまで妄想した。）

[tyoro1210]

技術者向けに最低限抑えてほしい文章術か。 あんま単語の誤用は見かないけど、自分が拾い読みしかしてない所為かな。　/ 意味が通じれば正しくなくても みたいなスタンスの人は一定数居そうではある。

[oakbow]

頷けるところの多い記事。要はもうちょい推敲しようぜって話。でもそっちに振れると投稿記事減っちゃうんだよね。俺自身推敲する方だと思うんだけど、いい表現が見つからなくて投稿やめちゃうことが割とある。

[joker1007]

概ねその通りで、俺もしばしば気になる時がある。パRubyとかパRailsを書いてた時はかなり注意していて、頑張って他の人が書いた所も日本語直したりしてた。それでも限界あったけどw 推敲はしっかりやろう。

[mrkn]

正しい日本語を使おうという話で、とても納得できる。

[yuuAn]

文法を曲げてでもタイトルに可変を入れるのは SEO のためな気がする。

[Haaaa_N]

別の意味になってしまうならともかく、問題なく通じるならいいじゃんよ 文学書いてるわけじゃないんだ

[kojin3251]

面白い

[onefootinthegrave]

qittaだったら細かい日本語についてとやかく言う気はないなあ。 どのバージョンでの話なのかだけは書いてほしいけど。

[UDONCHAN]

技術文書の文体について

[rail44]

「『値を返却する』という表現」を使うべきではない、でドキっとしたけど、Rustだと所有権周りの正しい文脈で使ってるなｗ

[tanakh]

まあプロが書く文章じゃないからね。単なる漢字の間違いはともかく、emのコンテクストとかは、スタイルの問題だし、技術用語の日本語約がまずいというのもまた違う問題だし、その辺ごっちゃにせずにカテゴライズすべ

[hi_yamamoto]

日本語ムヅカシイネ

[kurihara99]

「IPアドレス」を「IP」て略して書いてる記事見てちょっと残念と思ったことはある

[bouzuya]

タイトルで何を書いてあるのか分からないのが残念なポイント。おかしな日本語の表現などを指摘している記事。

[ngsw]

この手の話好き

[todesking]

大変そうだと思った

[amazedkoumei]

わし「手動で」って表現きらいやねん。理由はよくわからん。

[YuichiTanaka]

似た話だと「早い」と「速い」の誤用も気になる。

[cho45]

クソ文章書きがちなので胸が痛い…… 文章がクソだと全ての説得力がなくなる……………

[kits]

ありがちな言葉、用法の誤り。/ 「一つづつ」は現代仮名遣いの許容範囲内。

[mandel59]

うっ

[dynamicsoar]

「主題である固有名の説明が無い」以外は同意 // typographic error → typographical error https://en.wikipedia.org/wiki/Typographical_error

[kaz_hiramatsu]

英語の方が明確

[ikea_dless]

Qiitaの記事に限らない話し

[ymm1x]

ごめんなさい