Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita
はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ20年来多くのエンジニアの方々と同僚として接してきて思うことは、エンジニアの方の中には「文章を書く」ということに苦手意識がある方が一定数いるということです。 でもこの「テクニカルライティング」のスキルは、才能というよりは一種の「技能」だと思うんです。ある一定の原理原則を理解して実践を繰り返すことで、必ず一定レベルで習得できるものだと著者は信じています。 もしこのテクニカルライティングの原理原則をまだ体系的に学習したことがない、または過去学習したが改めて再学習したいという方に、お勧めのコンテンツを見つけたのでご紹介します。 https://developers.google.com/tech-writing Every engineer is also a write
詳細設計書ってあるじゃないですか。 - 室長のひとりごち
「詳細設計書ってあるじゃないですか。」 「あるね。」 「『必要ですか』って聞かれたんですけど。」 「そう。」 「必要ですかね。」 「何て答えたの。」 「成果物で決めているなら必要でしょう、って。」 「成果物なら必要だね。」 「『じゃあ、成果物じゃなければ必要ないんでしょ』って聞かれて。」 「何て答えたの。」 「詳細設計書で何を伝えたいか決まっているの、って。」 「質問で返したんだ。」 「まぁ、そうですが。でも、質問の意味が解らないし。」 「そしたら。」 「設計する人とコード書く人が同じならいらいですよね、って。」 「質問が変わった気があるね。」 「まあまあ。」 「それで。」 「同じ人なら確かにいらない、って。」 「マジで。」 「はい。」 「とっても限定されている条件下での話、だよね。」 「うーん、そうかも…しれないですね。」 「今のビジネスでそんな条件下、存在するんかい。」 「わからないで
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
