エンジニア歴20数年の私が、設計書を書く際に心がけていること - Qiita
はじめに 時の経つのは早いもので、私がIT業界に身を置いて四半世紀になってしまいました。 その間、膨大な数の「設計書（仕様書）」を書いて来ましたが、未だに悩み・迷いは尽きません。 それでも、亀の甲より年の劫とも申しますので、私なりの経験則を「個人」と「チーム」の両観点でまとめてみました。 本稿のテーマは、「主に設計書を想定した、開発ドキュメントの書き方」です。 本稿で前提とする設計書は、ExcelやWordで書かれた、フォーマルな（≒納品物になりえる）設計文書、です。 したがって、自社サービス開発よりも受託開発、アジャイルよりもウォーターフォール、を前提として読んでいただいた方が、しっくりくると思われます。 ＜ご注意＞ 本稿の内容は執筆者独自の見解であり、所属企業における立場、戦略、意見を代表するものではありません。 個人的に心がけていること 当該文書の作成目的や位置付けを冒頭に記載する
描写のwhyとhowーほんとに描写が苦手な人のための、表現を導く発想法
で、小説の文章は、場面、説明、描写からできているという話をしました。 今回は、そのなかで一番難しくて、「もう少し詳しく」というリクエストがあった、描写について考えます。 初級編なので、描写がとことん苦手な人のために、取っ掛かりになる考え方をひとつだけ取り上げます。 思っているまま言葉にしても伝わらない 作文で「（遠足に行きました。）楽しかったです。」とだけ書いて止まってしまう子供たちがいます（小学生並みの感想）。 作文指導だと先生は「どう楽しかったのかを書こう」と促します。 しかし、その子の中では〈楽しかった〉で完結しているので、どうもこうもありません。 これは何も子どもだけの話ではなく、人数で言えば大半の大人がほとんど同じです。 我々はほとんどの時間、世界を要約的に捉えています。 でないと世界から受け取る情報量が多すぎて処理できません。 要約的に捉えた世界を、捉えたままに書き出せば、当然
誰でも良い文章が書ける！Webライティング11のルール（スライド） | ベイジの社長ブログ
Web制作者を悩ませる問題に、「Webを熟知したコピーライターがいない問題」があります。特にメディア型のWebサイトの場合、文章の質がコンテンツパワー、ひいてはWebサイトの集客力・訴求力そのものになってきます。しかし現状、プロジェクトメンバーにコピーライターが参加しないのは当たり前になっています。 また、もしコピーライターをプロジェクトに参加させたいと思っても、Web特有のユーザ行動や設計思想、SEOなどに精通し、Webに相応しい文章を作ってくれるコピーライターは、この市場にごくわずかしか存在しないのではないでしょうか。 このWebのコピー問題は、考える以上に深刻です。なぜなら、文章の良し悪しで、コンバージョン率もユーザの満足度もブランドイメージも、簡単に変わってしまうためです。そして、その問題に対する私たちの結論は「全員でコピーをチェックして校正しよう」ということです。 私自身は今まで
物語は作れたがどんな文章で小説にしていいか分からない人のための覚書
前回の記事 生まれてはじめて書く人のための、小学生向け小説執筆マニュアル（手順書） 読書猿Classic: between / beyond readers について、物語の作り方はわかった気がするけど、それをいざ小説にしようとすると言葉が出てこない、なんとかしろ、という意見がありました。 実は、小説の文章についても少し書いていたのですが、あまりにも小学生向けでなかったので省きました。参考になる人がいるかもしれないので出してみます。 １ 小説の文章は何からできているか？ 小説は、文章を通して物語を伝えるものです。 小説の文章は、大きく３つに分けられます。 《場面》、《説明》、《描写》です。 （１）説明とは 《説明》は、物語を大づかみに述べる文章です。細かいところを省略して伝えるので《要約》と呼ばれることもあります。 大づかみなので、少しの文章で、長い時間の物語を伝えることができます。 わず
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
