プログラマーに贈る、わかりやすい文章を書くための技法 - LIVESENSE ENGINEER BLOG

これは Livesense Advent Calendar 2022 DAY 8 の記事です。 転職ドラフトでエンジニアをしている verdy_266 です。 僕の2022年を振り返ると、採用広報チームでの活動を無視することはできません。転職ドラフトの開発を行う傍ら、昨年末に採用広報チームにジョインし、記事の執筆や校正に多くの時間を割いてきました。 今まで記事を投稿したことがなかったこちらのブログにも共作含め5記事を投稿し、11月には Software Design への寄稿の機会をいただくこともできました。文章を書くことが思った以上に好きなんだなと発見があった年でもありました。 made.livesense.co.jp made.livesense.co.jp made.livesense.co.jp made.livesense.co.jp made.livesense.co.jp 弊

[verdy_266]

セルクマ。多くの記事を執筆したり校正したりしてきた中で、わかりやすい文章を書くために意識すべきことについて考えてみました！ぜひご意見お願いします！

[sicarot]

私は文を書く時に①伝えたいことを｢（主語）は（述語）｣の形にした上で理由などの修飾語を足すこと、②助詞の使い方を覚えること、③重文、複文程度の構造で終えること（それ以上は文を割る）が重要と指導してる。

[auto_chan]

「共有を行う」は「共有する」がいい。変に堅苦しく「所謂まぁ共有と言う様な行為を行ってして仕舞わ無いと言う事は有り得無い物だと先ず先に認識して置か無ければ成ら無い訳だが、」みたいな錯乱を稀にみかける。

[gorokumi]

入社試験で小論文書かせるのが正解よ

[tick2tack]

文の構造を明確にする、そのために助詞に気をつけると。/　プログラム同様ネストの深い文は理解しづらい。プログラムと違いカッコとかないのだからかかり関係が明確になるよう意識する必要がある。

[yojik]

自分は文章分割派 →「スクラムイベントで必要なコミュニケーションを行うことで、メンバー間の認識齟齬の解消や問題の早期発見と共有がしやすくなります。これがスクラムを導入するメリットの一つです」

[TriQ]

最近入ってくる子、助詞の使い方がおかしい子が多いんだよなぁ、、これって指導するの本当に難しいよね、誤字とかなら指摘すれば一発だけど助詞誤りは指摘しても本人が誤りと認識できない事が多いから

[gcyn]

『そうです、この文章は主語と述語が対応していないのです』省略具合、この文章においてはこれがベストでした？ みたいな感じ覚えて、ちょっと面白かったです。皆、頑張ってらっしゃるなー。

[cl-gaku]

主語と述語がまちまちの中学生みたいな作文客にメールするおっさんはどないして矯正したらええねん

[nisisinjuku]

いきなり英語を勉強しようとかやる気を折りに行くムーブｗ

[ene0kcal]

天才未満、平均以上の日本語母語話者にとって文章技法や話法を洗練ブーストするには英語学習によって洗練された良質の英文に触れるのは一つのルートだということであれば共感できる。

[nemoba]

そのような文章を綺麗にすることは難しいです。まず、文法的には「多くの環境では、productionのRDSスナップショットを開発アカウントへ共有することが一般的です」と書く方が自然です。AIでOK

[Flume]

「英語を勉強しよう」アホやろ。母国語がしっかり出来てないと外国語身につくわけないやん。

[minamishinji]

最近こういうのよく見るなぁ。

[diet55]

VSCode の「テキスト校正くん」などのtextlint は他人にメールを送るときには使っている。①主語などを明確にして、文意が誤解されて多様にならず一意になることとか、②主観と事実の区別に気をつけるとか。

[turanukimaru]

異議あり。英語とは言っても論文英語とか無生物主語の英語であるべき。わかりやすい文章ではなく解釈の必要のない文章を目指すべき。日本人は相手にわからせたがりすぎる。分からなくても利用できる文章を目指せ。

[mohri]

1つ目の例は2つの構造が入れ子になっているので、分離して2文にするという解もありそう→「スクラムイベントで必要な……早期発見と共有がしやすくなる。これがスクラムを導入するメリットです」みたいな

[yug1224]

最近Advent Calendarのレビューやっていて、ライティングの技術ってめちゃくちゃ難しいなって感じる

[akid3020]

英語を勉強すれば主語と述語を意識するようになる→日本語の文章能力のために英語を勉強しましょうは飛躍があるというか極端すぎる気はするかも…

[aox]

7、7、7、5調で書けば唄えます

[iwtn]

もしかして、日本語の文法自体を中々習得する機会が少ない？なんとなく使えるからなぁ……高校までの授業だと文学の方になっちゃうし。

[katainaka0503]

英語学習等で自分が使う言語をメタな視点から見直すの、良い訓練になりますよね

[mnmandahalf]

英語を勉強すると一文の構成を意識しやすくなるのわかる