![LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた](https://cdn-ak-scissors.b.st-hatena.com/image/square/bd15d291e6ef042a61b787ba0995c32d5e3037d6/height=288;version=1;width=512/https%3A%2F%2Fvos.line-scdn.net%2Flandpress-content-v2_1761%2F1666853712410.png%3FupdatedAt%3D1666853713000)
こんにちは。ハウスマートの高松(@t2kmt)です。 皆さんは開発要件をまとめるのにどんなフォーマットを使っていますか? 開発要件をいい感じにまとめるのって大変ですよね。 ドキュメント整備せずに開発に着手し始めてしまうと手戻り抜け漏れが出てしまいますが、一方で要件定義書をガチガチなフォーマットにするとドキュメントの作成自体の工数が増えてしまいます。 スタートアップはスピードが命。ドキュメントを書きまくって開発が進まないなんて言語道断です。 開発要件の整理はプロジェクトの成否に多大なインパクトを与えますが、ほとんどの現場では企画を考える人にフォーマットが委ねられていることが多いと思います。 今回は皆さんが快適に開発要件をまとめられるように、ハウスマートで利用している mini spec というフォーマットをご紹介します。 mini spec とは mini spec とは開発の要件をまとめる
This is why you shouldn't interrupt a programmer (なぜプログラマの作業に割り込むべきではないか) という4コマ漫画が話題になっていた。これは別にプログラマではなくても「わかるわかる」という感じの話。 コメントを見ると、だから作業を中断してもすぐ再開できるように自分の考えることをなるべく書き出すようにしているという人が結構多かった。なるほど。 今日は雨が降ったせいで予定が一つキャンセルになったことだし、ちょうどいい機会なので、文章で何かを書くということについて自分が思っていることを書いてみようとおもう。以前 Software Design のドキュメントの書き方特集みたいな号に似たような趣旨の話を寄稿したのだけど、「書く」というのは単に物事を忘れないようにするための行為に留まるものではなくて、自分の考えを整理するための道具なのだ、ということが
タイトル通りだ。お前は自分の好きなものを長々と褒めちぎるテキストを書くべきだ。人に勧めることを意識すると更に良い。レビューなんかでも良い。人生ベストのリストみたいな形態でもOKだ。とにかく、「俺はコレが好きで、こういうところが最高で、これをお前らに知ってほしい!」というのを書いていくべきだ。 僕たちは地獄のような時代を生きている。何かを茶化すだけの低俗なミームが蔓延り、焼き直しのような非生産的なネタがいつまでも受け、煽り記事はいつまでも消えず、パラノイア野郎はどこにだって湧いてくる。 僕はもう飽き飽きしてしまった。インターネットの使われ方自体が変わっていってるのはわかっているが、それにしても今の状況は酷すぎる。ずっと前から酷いが、年々ヤバくなっている。ウンザリだ。 だからせめて自分だけでも、と思い、このnoteで萌え語りを始めたのが最近のことなのだが、これが思った以上に楽しい。オマケに記事
サービスを運営していると、最適な文章を書く事も多いです。分かりやすい文章を書く事でユーザーに対する理解が深まり、結果的にグロースに繋がります。 今回は、この記事だけを読んでおけば必ず文章力が向上する記事をまとめました。 文章力がどんどん向上する5つの書き方・トレーニング方法 ライティング力が向上する書き方と、文章力を向上させるためのトレーニング方法が書かれた記事。 第2回:わかりやすい文章の10大原則 理解される文章の10個の原則について書かれている記事。 文章のプロ直伝!素人でもプロ並に書けるようになる5つのテクニック プロのように書くための5つのテクニックについて解説されている記事。 有名小説家が伝授する、ショートストーリーを書くための8つの法則 文章を書くプロである小説家の文章を書くコツがまとめられている記事。 読みやすい文章を書くための技法 読んだ人が、しっかりと理解をしてもらう
忙しい人のための要約 以下の5つのパートで文章を構成する。 A.〈はじめ〉 ……内容の紹介・要約 B1.〈なか1〉 ……具体例その1 B2.〈なか2〉 ……具体例その2 C.〈まとめ〉 ……具体例の共通点 D.〈むすび〉 ……上記の共通点の一般化〈としての主張〉 書く順序は次の通り。 1.具体例をあつめる→〈なか1〉〈なか2〉 2.具体例の共通点を書く→〈まとめ〉 3.まとめから言えること(主張〉を書く→〈むすび〉 4.内容を簡単に紹介する入口を書く→〈はじめ〉 (ほかに参考になりそうな記事) ・文章の型稽古→穴埋めすれば誰でも書ける魔法の文章テンプレート 読書猿Classic: between / beyond readers ・物事を論じられるようになるスモール・ステップス→米国の小学生が使う思考ツール 読書猿Classic: between / beyond readers 書くこと
このドメインは お名前.com から取得されました。 お名前.com は GMOインターネットグループ(株) が運営する国内シェアNo.1のドメイン登録サービスです。 ※表示価格は、全て税込です。 ※サービス品質維持のため、一時的に対象となる料金へ一定割合の「サービス維持調整費」を加算させていただきます。
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く