Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita

はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write

[Windfola]

一方でgoogleのヘルプが役に立った試しが無いという悲しみ。

[koreyonda]

あわせて読みたい：結城浩氏の文章教室 https://www.hyuki.com/wl/ やAmazonの従業員が学ぶ伝わる文章構成の極意 https://b.hatena.ne.jp/entry/s/note.com/sangmin/n/n8f04510d12ed Oneに挙げられた一貫性と曖昧さの排除ができるだけで文章は変わる。

[micromillion]

「理科系の作文技術」とかぶるところも多いか

[kowa]

箇条書き（ドットリストとナンバードリスト）の使い方をきちんと説明したのを初めてみた。たいていの文章術は箇条書きをタブーとしてる。英語はやはり動詞なんだねえ。

[UME]

Googleのドキュメントそんなに良いですかね？？？

[otihateten3510]

学校で教わりたいよねこういうのは

[remix-cafe]

高校ぐらいでこういうの習っていたかった。

[ayakohiroe]

基礎資料はすばらしい。テクニカルだけでなく、普通の社会人としてメールでも資料でも文章力に役立つところがある。が、これを読んだからといって全員ができる、というのはまた別問題。

[poreSquared]

初ブックマーク

[aceraceae]

つい最近技術資料書いたばかりだしまた必要になるかな。

[naglfar]

できるだけ気をつけたい。

[hsato2011]

google社が展開しているテクニカルライティング資料に関する記事。あとでやること

[trkbt10]

Googleのドキュメントめっちゃくちゃ分かりにくいと思う

[HAZI]

照明の話じゃなかった…

[tmatsuu]

わいわい

[kenjou]

Googleのドキュメントってすごく読みづらいのだけど、この教育は本当に正しいのだろうか。

[naoki0311]

いろいろな物書き時にする

[anklelab]

“Google翻訳などで十分に理解できます。”読みやすい文章は自動翻訳もしやすいよね。

[laptice]

Webサービスのオンボーディング機能を作る時にも大切な視点。口頭でやると面倒臭がられるやつだけど（笑

[showyou]

読んだ。要点はわかりやすく、参考になる。

[wapa]

この手のライティング技術は基礎教育としてもそうだけど、節目節目で見直せるようになってるといいかも。実際に読み書きする必要に迫られた後と前では本人の感じ方もモチベーションも変わってくるので。

[koji28]

あとで読まなきゃ(´・ω・`)

[motch1cm]

「ドキュメントを書く能力」って体系的じゃない上に学ぶ機会が少ないよね…？

[pongeponge]

Technical Writing One の内容は論文書くときに何度も言われたなぁ

[oyssi]

ブコメ有用

[zgmf-x20a]

論文で能動態でと言うのは、この歳に夏で言われたことだな。

[aoki789]

論文書いたらできるようになるよ

[kapibara]

あとでよむ。理科系の作文技術懐かしい。

[kwhrtsk]

Oneのような文章表現のスキルは訓練が容易なんだけど、何をどのような構成で書くかの方が重要で、それが難しい。ソフトウェア設計と同じで一定のパターンはあるんだけど、最終的にはセンスか経験が必要な気がする。

[susieq]

お、面白そう

[hitorivo]

タイトルとリード文、 PREP法で1段落1トピック、図表とキャプション、リスト。文章のスタイルはプレインイングリッシュ。

[morinaga3]

文章

[Windymelt]

“強い動詞”は『リーダブルコード』でいうところの「カラフルな言葉」にあたりそう。

[yug1224]

義務教育で習いたかった

[kaakaa_hoe]

読もうと思ってずっとタブに残ってるやつだ…

[mainyaa]

いいねー