開発ドキュメントの書き方！9つのコツ【エンジニア】
文章を書く前にやることよい文章を書くには、実際に文章を書く前に、読者は誰か、どういう悩みを解決するのかを企画することが大切です。また、それを元にアウトラインを書いておきます。 このふたつを元に文章を書くことで、読みやすい開発ドキュメントにつながります。これについては、次の記事をご覧ください。 開発ドキュメントを書く前に決めるべき3つのこと【企画編】開発ドキュメントにおけるアウトラインの書き方開発ドキュメントの書き方企画とアウトラインの作成が終わったら、実際に文章を書いていきます。文章を書くときは、次の9つを意識して書きます。これだけで、読みやすさ、分かりやすさが大きく向上します。 一文を短く切る結論を先に述べる指示語を使わない主語を明確にする、述語との距離を近づけるひらく・閉じるを統一する再現条件を示す前提を揃える見出しや箇条書き、表などを適切に用いる読者に伝わる用語を使うひとつずつ説明し
Cloudflare D1 がヤバい
まだ検証足りないけど、マジで想像通りのブツなら魂震えるかもしれん…。 Announcing D1: our first SQL database Cloudflare D1 = Edge SQLite Cloudflare D1 は Cloudflare Worker で、つまり CDN Network 上で sqlite が動きます。これだけなら普通の sqlite ホスティングなんですが、もちろん Cloudflare が出すからにはそれだけではなく、CDN Edge 上に Read Replica がバラ撒かれた sqlite になります。ヤバくないですか？ 僕はヤバいと思いました。 このヤバさを知るために、Cloudflare が開発した基盤についていくつか抑えておく必要があります。 Durable Objects は CDN 上の Actor モデルを構築できます。この Acto
西川きよしさん 運転免許証を返納 「よい思い出があるうちに」 | NHK
漫才師の西川きよしさんが、車の運転免許証を返納し、11日、大阪の警察署で本人確認の証明書として使える運転経歴証明書の交付を受けました。 西川きよしさんは去年7月に75歳になり、このところ視力や聴力に衰えを感じることがあったということで、ことし2月に50年以上持っていた運転免許証を返納しました。 11日は大阪・箕面警察署で免許証を返納する代わりに本人確認の証明書として使える運転経歴証明書の交付を受け、警察署長から「長らくお疲れ様でした」などと声をかけられていました。 西川さんは返納に至った経緯について「スタジオにいるときにも視力や聴力で衰えを感じることがありました。これは運転でも同じだと思い、家族とも話をして、よい思い出がたくさん詰まっているときに返納しようと決断しました」と話していました。 西川さんは若いころ、車の修理工をしながらどうしても車が欲しいと思っていたということで「やっさんと組ま
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
