エンジニア歴20数年の私が、設計書を書く際に心がけていること - Qiita
はじめに 時の経つのは早いもので、私がIT業界に身を置いて四半世紀になってしまいました。 その間、膨大な数の「設計書（仕様書）」を書いて来ましたが、未だに悩み・迷いは尽きません。 それでも、亀の甲より年の劫とも申しますので、私なりの経験則を「個人」と「チーム」の両観点でまとめてみました。 本稿のテーマは、「主に設計書を想定した、開発ドキュメントの書き方」です。 本稿で前提とする設計書は、ExcelやWordで書かれた、フォーマルな（≒納品物になりえる）設計文書、です。 したがって、自社サービス開発よりも受託開発、アジャイルよりもウォーターフォール、を前提として読んでいただいた方が、しっくりくると思われます。 ＜ご注意＞ 本稿の内容は執筆者独自の見解であり、所属企業における立場、戦略、意見を代表するものではありません。 個人的に心がけていること 当該文書の作成目的や位置付けを冒頭に記載する
「いい文章」を書くための３つのルール／まずはパソコンを閉じましょう？ - デマこい！
アカウントを取った。ブログのデザインも決めた。書きたい内容もだいたい決まっている。よし、書くぞ――。と、パソコンの前に座った瞬間に、頭のなかが真っ白になる。記事を１本書き上げるという最初のステップでつまずく人は多い。文章術をまとめたサイトもあるけれど、どうもイマイチ役に立たない。一体なにが足りないから、あなたは文章が書けないのだろう。やっぱり、才能？ ソーシャル・ブックマークのすばらしいところは、すべての文章が「生存競争」をしていることだ。まるで自然選択にかけられる生物のように「いい文章・おもしろい文章」だけが生き残る。そして「生き残った記事」とそうでない記事を比較すれば、「いい文章」の共通点が見つかるはずだ。 断言するが、文章を書くのに才能はいらない。「いい文章」の条件はたったの３つ。この３つさえ守っていれば、誰だって読みごたえのある記事を書ける。たぶん。 １．「謎」には「答え」がなけれ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
