開発者が考える提案書テンプレート markdown版 - Qiita
概要 定型的な システム開発 では以下のような設計書が使われる。 システム要件定義 システム方式定義 ソフトウェア要件定義 ソフトウェア方式設計 ソフトウェア詳細設計 しかしそれ以前に 開発者目線、開発者発信で顧客に提案する概要資料を作りたい ケースがある。あるいは就職活動時の自身のポートフォリオを採用担当に説明することも同様かもしれません。 オードリー・タンがコード書く前にまずreadme.txtを書く話、Yahoo!がプロダクト開発の最初にプレスリリースから作る話、自分が前職で商品企画する際にまず広告から考えていた話、どれも明確なゴールイメージをまず確定させて必要要件を定義していくという意味で全部共通の考え方 — 菅俊一 / Syunichi SUGE (@ssuge) February 2, 2021 なんて話も。 技術とマーケティングのちょうど中間、開発者と顧客との意思疎通の橋渡し
秋田こまっち。 - 段落の一字下げをなぜしないのか
１．はじめに 初めのうちは特に何も思わず文を書くだけでした。ですがCSSを意識しだしてから他サイトがどのように表現しているのかあちこち見てまわっているのです。その結果、色々なサイトで表現がてんでばらばらになっているので弱りました。もう少し調べたところ、どうやらサイトでの文章表現の問題の一つに「段落の行頭の一字下げ」があるみたいなのです。 この問題の論点は単純で、「一字下げで段落を表す」か「一行開けで段落を表す」のか、果たしてどちらが好ましいかといったことです。このことについてちょっと首をつっこんでみました。 ２．紙の文章とWebの文章 紙に書かれた文章とWeb上の文章の幅には実は大きな違いがあり、普通、紙に書かれてある方が幅が小さいようです。そのため紙の文章は一字下げだけで十分と言え、段落ごとに空白を入れなくても私達はスイスイと読めるのです。 ですがWeb上では環境にもよりますが基本的に横
【DL版】エンジニアのための日本語文章テクニック 〜明日から「読みやすいね」と言われよう！〜 - kanamezuki - BOOTH
累計500部突破！ 理系出身小説家による、「読みやすさ」を支える技術本！どれだけしっかり考えて書いても、「読みにくい」「わかりづらい」と言われてしまう。 もう嫌になる、どうせ理工系の人間には文章力がないんだ。 なんて思っていませんか？ それは大いなる誤解です。 理工系の人間が持つ文章力は、決して低くありません。ただ、使い方を間違えているのです。 この本の著者は、高専電気科を卒業し工学単科大学へと進学した、バリバリの理工系人間です。 しかし、現在は文章書きの専門職である小説家（ライトノベル作家）として活動しています。 デビュー作では、当然のように「読みにくい」と言われまくりました。 ですが今では、「読みやすい」とのお声をいただくことがほとんどです。 いかにも理工系っぽい「読みにくい」文章の書き手であった人間が、商業出版のエンタメ世界で血を吐きながら会得した、「読みやすさ」のための技術。 それ
推敲 - Wikipedia
推敲（すいこう）とは、文章を何度も練り直すこと。 唐代、都の長安に科挙（官吏の登用試験）を受けるためにはるばるやってきた賈島は、乗っているロバの上で詩を作っていた。その途中、「僧は推す月下の門」という一句を口ずさんでから、「推す」のほかに「敲く」という語を思いついて迷ってしまった。彼は手綱をとるのも忘れ、手で門扉を押すまねをしたり、叩くまねをしたりしたが、なかなか決まらなかった。あまりにも夢中になっていたので、向こうから役人の行列がやってきたのにも気づかず、その中に突っ込んでしまった。さらに悪いことに、その行列は知京兆府事（長安の都知事）、韓愈の行列であったため、賈島はすぐに捕らえられ、韓愈の前に引っ立てられた。そこで彼は事の経緯をつぶさに申し立てた。優れた名文家であり、漢詩の大家でもあった韓愈は、賈島の話を聞き終わると、「それは『敲く』の方がいいだろう、月下に音を響かせる風情があって良い
わかち書き - Wikipedia
わかち書きがされた英文の日記 わかち書き（わかちがき）とは、文章において語の区切りに空白を挟んで記述することである。分かち書き[1]、分ち書き[1][2]、別ち書き[2]、分書[3]とも表記する。分別書き[3]、放ち書き[1]とも。 日本語は、通常の文章では、空白（スペース）によって語を区切ることはない。日本語の通常の文章は仮名漢字交じりなので、漢字、カタカナ、ひらがな等の文字種の違いや、句読点や中点によって語や文章の区切りを識別する。しかし、句読点をこのような目的に使用するせいで、文構造や修飾関係、節の切れ目などを表わす機能があいまいなものになっている。句読点を付ける厳密な条件は決まっておらず、また一種類のみの文字種で構成された文章では、文章は語の区切りを誤りやすい。単語の区切りを誤って読むことは、「ぎなた読み」と呼ばれる。 例えば、 こうしまるやさいいち という文は、「講師丸谷才一」と
文才の有無に関係なく、誰でもそれなりに整った文章を書くコツ｜村井 弦｜文藝春秋
文章の書き方に正解はない。 ただ、ちょっとした「コツ」みたいなものはあると思う。 僕は会社に入ってから9年間、「週刊文春」と「文藝春秋」の編集部で、文章に携わる仕事をしてきた。 たかだが10年足らずの経歴で何を偉そうに、と思われる方もいるかもしれないが、最近になってようやく、「文章を書くコツみたいなものがあるのではないか？」ということに気がつき始めた。 もちろん一流作家のような芸術的で天才的な文章を書くコツではない。文才の有無は関係なく、誰でもそれなりに整った文章を書くためのコツだ。 noteをやっている人の中には「何かを書きたい、でもどうやったら書けるだろう」と思っている人がいると思う。また、「書きたいんだけど、素人の書いた文章みたいに読まれたら恥ずかしいな」と思って、躊躇している人もいるかもしれない。 さらに、「周りから『何でもいいからとりあえず書いてみたらいい』と勧められるんだけど、
[Solved] 日本語文章中、英単語の両端にスペースをつける人 - Qiita
私ですね。 いるいるって言わないでもらえると嬉しいです。 そうする根拠はいくつかありますが、私はマイクロソフト系言語をメインに使うプログラマなので、マイクロソフトの公式サイトがそうなっていることが大きいです。 そんなものは機械がやるべきことで、人がやることではない。 たとえば Word なら自動的に調整してくれる。 （↑ これです） わかっています。 でも染みついてしまいました。 質問に答えます。 ――疲れませんか？ 習慣になっているのでそれほどではありません。 ――時間の無駄では？ 一連の動作になっているのでそれほどではありません。 どうかコストの浪費と咎めないでください。 ――意味あるの？ 見やすくはなると信じています。 ――本当に？ 昨晩Generative Artに関する論文をMicrosoft Wordで書きました。 よりも 昨晩 Generative Art に関する論文を M
![[Solved] 日本語文章中、英単語の両端にスペースをつける人 - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/56849bc68452735e5ffd3cfd6e6669e9f4a80365/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9JTVCU29sdmVkJTVEJTIwJUU2JTk3JUE1JUU2JTlDJUFDJUU4JUFBJTlFJUU2JTk2JTg3JUU3JUFCJUEwJUU0JUI4JUFEJUUzJTgwJTgxJUU4JThCJUIxJUU1JThEJTk4JUU4JUFBJTlFJUUzJTgxJUFFJUU0JUI4JUExJUU3JUFCJUFGJUUzJTgxJUFCJUUzJTgyJUI5JUUzJTgzJTlBJUUzJTgzJUJDJUUzJTgyJUI5JUUzJTgyJTkyJUUzJTgxJUE0JUUzJTgxJTkxJUUzJTgyJThCJUU0JUJBJUJBJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMxRTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmcz00NTIxYTYzYzgyMzEwMTI5OTc4NWIwODdjM2ZkOTRkMg%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBDb2RlT25lJnR4dC1jb2xvcj0lMjMxRTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9MzYmdHh0LWFsaWduPWxlZnQlMkN0b3Amcz04YmQ5YzQxZGI3MTliZjlkOTJiNzNjMzUwZGYyZjlkMg%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3D5f2b1db1ce8d52f8a5074d9ba9c120dd)
「という」と「こと」を減らすだけで、文章はぐっと読みやすくなる｜Ryo Yoshitake | THE GUILD
と思っている話です。もはやタイトルでぜんぶ言ってしまった。 せっかくなのでもう少し続けます。 2020/05/03追記：第二弾？書きました この本がまだ初稿になる前、共著者のみなさんと執筆真っ最中の頃に何度か打ち合わせがあったのですが、そこで「書籍的な文章を書き慣れてない人って、"という"と"こと/もの"を多用しがちなので、この2つを抑えるだけでも文章がシュッとするんですよ」とお話したら思ったより反応があったので、これは需要があるんじゃないかと感じたのがきっかけです。 ここから先は具体例を交えて解説していきます。 さすがに他人様のテキストを使うのは気が引けるので自分が書いた記事を例に挙げます。……でも自分はこのテクニックを使うようにしているので、該当する記事がなかなかないんですよねぇ……と思ったらあった！ （よりによってこれか……せっかくなので皆さんスタァライトを観ましょう！） 記事中では
体言止めがあいまいさをもたらす場合がある
これも報告書下読み業務の中で遭遇したものです。 文脈は前回記事と同様、社員Ａ、その上司Ｂ、役員Ｃという関係の中で、社員Ａから役員Ｃに向けて、「今期のプロジェクトではこのような仕事をしました」という報告をするためのものです。その中で「期間中の業務報告」の欄に次のような記述がありました。 【成果】 ・Androidアプリ開発の基本を理解 ・デバッグツールを使用しバグを追跡する方法の理解 ・報告・プレゼンテーションスキルの向上 さて、この箇条書きのどこが「あいまい」なのでしょうか？ このように列挙するタイプの情報は、文章で書くよりも箇条書きのほうがわかりやすいことが多いのですが、ひとつ気をつけておくべきなのは「体言止め」です。この例はいずれも「コーディング」「理解」「向上」と、名詞で文を締めくくる「体言止め」という書き方をしています。このスタイルを報告書で使用する場合は注意しなければなりません。
よい設計書である条件は「動詞」を使うことだ - Fight the Future
設計自体が妥当かどうかは判断できないけど。 設計書を読んでみてほしい。 文の末尾が「名詞」で終わってない？ 僕の経験だけで判断しているけど、システム開発における設計書の文は「名詞」で終わっていることが非常に多い。 保存ボタンを押すと、○○を登録。 みたいな。 動詞を使わないということは、文章の基本文型である主語・動詞の形式をとっていないわけで。 基本すら満たしていないのだから、その文は理解しづらいに決まっている。 つまりは文章を体言止めにしないってことなんだけど、 文が長いとか、複文になっているのに体言止めを使ってしまうと本当にわかりづらい。 保存ボタンを押すと○○を登録し、キャンセルボタンを押すと○○を破棄、△△画面に遷移。 動詞にすることで、その文の動作、すなわち働きをきちんと伝えられる。 ぜひ文章を書くときは、しっかりと動詞を使うことを意識してほしい。 それだけでけっこう文章のレベル
体言止めで文章を書くな - Murga
「わかりやすい」文章を書く全技術100 作者: 大久保進出版社/メーカー: クールメディア出版発売日: 2016/04/09メディア: Kindle版この商品を含むブログ (2件) を見る メモ、コードコメント、メール、報告書。こうしたビジネスにおけるあらゆる文書において、体言止めで書かれた文章が分かりやすかったためしがない。 例えば、 昨日の作業：○○画面のデバッグ 本日の作業予定：○○作業の実施 // ここで ○○ API を使用 コミットコメント : 「クラス名の修正」 こうした体言止めの一文だ。 これらは全て、何をやったのかがハッキリしない。自分の行動・成果を報告する文章としては最低最悪だ。 昨日の作業：○○画面のデバッグ デバッグを、やったのか？やらなかったのか？どのくらいやったのか？そもそも「デバッグ」という行動 (動詞) は、何を行うことと定義しているのか？進捗が何も分からな
箇条書きより見出しを好め - koicの日記
Wiki や esa なんかでひたすら箇条書きで記されているのを、最近たびたび見かけるようになった気がしたので話していた、文書構造のリファクタリングテクニックとなる。 基本は一番浅い箇条書きを大見出しにして、ネストを一段ずつ下げるといったものでざっくり以下のような図解で話していた。以下の例では大見出しになったものをタイトルとしており、中見出しが一番浅い箇条に対応している。初手としてはかなり手早く手を加えることのできるテクニックのひとつだと思う。 もちろん箇条書きが良くないといったものではなく箇条として成立していればよい。良くないのは箇条の重ね書きの結果として、箇条書きの4段ネストといったものなどで、それは既に箇条として破綻していたりする。そういった structure smell を作らないように積極的に見出しを導入しておくのがひとつの解だと思っている。 広く普及していると思われる Mar
エモい文章を書くための24の視点
個別具体な方がよいものすごく個人的なエピソードは、いつだって本人が思っている以上に、他人を惹きつける。 形容詞をかみ砕く「嬉しい」「楽しい」「美味しい」と書いただけじゃ、残念ながら何も伝わらない。自分の感覚にこそ、言葉を尽くしてみる。何にでも当てはまるテンプレ語彙を使わないよう、細心の注意を払う。 自分にとっての当たり前がコンテンツ盲点、自分と他人は違う。だから、ケンミンショーは盛り上がるし、ジャパンはミステリアス。自分の、自分たちの当たり前は、他人にとっての十分な驚きになり得る。 コロケーションをねじれさす意図的に、当たり前をずらしてみる。音を触ってみたり、キッチンに潜ってみたり、カメラで歌ってみたり。 ちょっと飛躍させるロジカルな文章に飛躍は禁物。誰にでも同じように理解させる必要があるから。エモにアプローチするなら、読んだ人それぞれ違う感想を持ってもらってよい、その方がよい。だから、詰
サカイ引越センターの16年4～12月期、純利益12.9%減29億円 - 日本経済新聞
サカイ引越センターが25日に発表した2016年4～12月期の連結決算は、純利益が前年同期比12.9%減の29億円となった。売上高は前年同期比7%増の558億円、経常利益は前年同期比2.5%増の50億円、営業利益は前年同期比1%増の47億円だった。株式会社SDホールディングスの子会社化に伴う仲介手数料の支払い1億4700万円や、第2四半期連結会計期間より株式会社SDホールディングス及び子会社3社
日本人誰もがMarkdownを真に理解していない
Markdownとは、はてなブログでも採用されている表記法のこと。 # こういう見出しを書いたり 1. こういうリストや 1. こういうリスト …を書くといい感じに表示されるやつね。 これをカタカタ打ち込んで投稿すれば、キレイに装飾されたブログ記事ができあがる。 似たようなものだと「はてな記法」やPukiWikiの記法も流行ってたけど、なぜだか今はMarkdown一択の時代。 なぜMarkdownだけが勝ち残ったのか？ というと諸説あるかと思うけど、Markdownには他の表記法と決定的に異なる点がある。それは「メールで慣例的に使われていた書き方そのものである点」。 日本の企業戦士がメールを書くとこんな感じだろう。 第二営業部 ＊＊様 いつもお世話になっております。第一営業部 永尾です。 お忙しいことは重々承知しておりましたが、またこのようなメールをお送りすること、何卒ご容赦ください。 第
おもしろいブログの書き方 - ちるろぐ
こんちは。ブログ歴10年のチルドです。 今日は「ブログ」について書きますよ。 ブログにちょっぴり興味があるけど、書き方がわからない、もしくは、やったけどすぐに止めてしまったという人。 そんな方々に、ぜひ読んでほしい「おもしろいブログの書き方」を紹介します。 ブログの書き方 ブログをやったことのない人や、すぐに止めてしまった人に共通してるのは「どう書けばいいのかわからない」ってこと。 一方で、お金が欲しくて始めた、いわゆるアフィリエイト目的の人はわかりやすい。あっちは、いかに商品を売るかという、いわば仕事だからです。 じゃあ、趣味のブログってなんなの？、という話ですよね。日記を書けばいいのかというと、そうでもない。日記なら手帳に書けばいい。 つまり、ブログは、日記ではなくコンテンツにしなければならないのです。 日記とコンテンツの違い では、日記とコンテンツの違いを「ローソンで肉まんを買った話
英語の句読点 - スラッシュ
スラッシュの役割 stroke、virgule、その他、斜めであることから slant, diagonal、あるいは、コンピュータ関連の表記であるバックスラッシュ(\ back slash) に対比させて forward slash など、いろんな呼び方がありますが、スラッシュとは、複数の言葉を並べてその間に置く斜めの棒のような符号のことです。中世のヨーロッパでは、もともと、スラッシュ1個（/）でコンマ、２個（//）でダッシュのような使い方をされていたようです。このスラッシュが現在のハイフンに発展したとも言われ、ハイフンやダッシュ（エヌ・ダッシュ）のように「2つのものの関連性」を表すという役割があります。 たとえば、A/B でスラッシュで挟まれた A と B はどちらでも該当するという意味になります。なかでも、最も多い用法は、読者の立場や状況によってどちらを選んでもよいという意味でよく使わ
日本人なら知っておくべき()の前後の半角スペースのこと - cBlog
前回の記事で紹介した動画を観ていると、いつも引っかかることがある。 yaritakunai.hatenablog.com 1つ目の動画のタイトルだ。 タイトルが英語で書かれているにもかかわらず、“()”（半角かっこ）の前後に（必ずしも）半角スペースが無い。 少し煽り気味な言い方をすれば、気持ち悪いと思わないのかな。 ひらがな・漢字の使い方や句読点の打ち方など、書き方が筆者に委ねられている日本語と異なり、英語には正書法というのがあって、正式な書き方が存在する。 というか、ほとんどの言語で存在している。 そういう言語である英語を使うときは、規則正しい書き方を意識してほしい。 英文におけるスペース スペーシングを直して問題のタイトルを書くと、次のようになる。 アンジュルム『大器晩成』(ANGERME [A Late Bloomer]) (Promotion edit (New Ver.)) 直し
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
科学技術論文の書き方 学術論文の書き方
技術文書アンチパターン集
