ドキュメント作成時のあるあるアンチパターン20 - Qiita
業務でドキュメントを作成するケースは多々ある 例：仕様書・設計書・提案書・メール・障害票．．． ここでは各ドキュメント共通してありがちなアンチパターンをまとめてみました。 1. 表記がバイト表示・マイクロ秒表示 プログラムが出した数値をありのままに表示するパターン ファイルサイズが100MB, 1GBあろうと、バイト表示にする 桁数が多い数値に、桁区切り（,）を入れない 時間を何でもマイクロ秒・ミリ秒にする（1/100万秒までの精度が必要？体感で分かる？） 桁数が多い＝精度が高い＝良い文書、ではなく、見る人が必要とする精度に切り上げることが重要（売上で１円単位まで出すことが無いのと同様） 悪い例 No ファイル名 ファイルサイズ(byte) 処理時間(秒)
textlintで日本語の文章をチェックする
textlintはMarkdownなどテキスト向けのLintツールで、テキスト版ESLintみたいな感じのツールです。 JavaScriptでルールを書けるテキスト/Markdownの校正ツール textlint を作った | Web Scratch 最近azu/JavaScript-Plugin-Architectureという小さな書籍を書いていて、色々簡単に使えるような仕組みを追加しています。 この記事では簡単なtextlintの導入方法について紹介します。 公式サイトには一部ルールを含むオンラインデモが公開されています。 textlint · The pluggable linting tool for text and markdown ドットインストールにてNode.jsのインストール、textlintの利用方法、エディタとの連携などのチュートリアルが公開されています。Node.
読点を減らせば文章力が上がる - CGMプランナーの思考
僕は声高にそう主張したい。 たとえスラムダンクのオープニング曲が流れたとしても、僕は「読点を減らせば文章力が上がる」と叫びたい。 世界の中心でも「読点を減らせば文章力が上がる」を叫ぶつもりだ。 文章力とは何か。読点とは何か。 それを知ればなぜ僕がこうも主張するのか、わかってもらえるだろう。 そもそも文章を書くということは、情報整理との戦いだ。 文章は一本の線なので、読者には一つずつしか情報を渡せない。かといって伝えたい情報を一度に伝えきるのは難しい。 だから上手く物事を伝えるには、一度に渡す情報の適切な量と順番を考なければならない。それが文章を書くということであり、その能力こそが文章力である。 そして読点とは、読者依存だと思っていい。 誰もが知っていることだが、日本語の読点は文章内の「、」という記号である。 では「、」自体の意味は何か？ そんなものはない。「、」は情報の空白なのである。 し
RedPenを使って技術文書を手軽に校正しよう 記事一覧 | gihyo.jp
運営元のロゴ Copyright © 2007-2024 All Rights Reserved by Gijutsu-Hyoron Co., Ltd. ページ内容の全部あるいは一部を無断で利用することを禁止します。個別にライセンスが設定されている記事等はそのライセンスに従います。
Revisions of "技術的な文章を書くための1歩、2歩、3歩" - Qiita
This is a revisions of "技術的な文章を書くための1歩、2歩、3歩"
生まれてはじめて書く人のための、小学生向け小説執筆マニュアル（手順書）
創作論とか小説の書き方みたいな本について言うと、作家やその周辺の人が書いているせいか、かつてはその困難さを前面に掲げて、結果的に創作行為の神秘性を保守する手合が多かった。 近頃は「誰でも書ける」みたいなのも随分増えたけれど、タイトルだけ付け間違えたようなのが多くて、あいかわらず、もったいぶった文士臭さが抜けてない。 探す場所を間違えたのだと考え、はなっから「創作行為の神秘性」なんて受け付けない人たち向けに書かれたものを探した。つまり子供向けである。 学校の課題になったりするせいか、アメリカのものに、手続きだけに注力した実にアッケラカンとしたのが多かった。 ネットでフリーで手に入るものだと、National Novel Writing Month（通称：NaNoWriMo ※）のYoung Writers Program用ワークブックが、ほぼ同じ手続きを小・中・高校生向けの３種類に書き分けて
読みやすい文章を書くコツ。 - 日々、とんは語る。
最近、文章を書くことが非常に多くなってきたのですが、面白さとか、心に残るとか、そういうのを狙って書くのはとっても難しいです。 センスというのは人それぞれなので、僕の場合、そういった部分はおいといて、とりあえず、読みやすさだけを非常に気をつかって書いています。 声に出して何度も読み返す。 読みやすい文章を書く上で、僕が最も頼りにしているのは、音読することです。 書くときもそうですが、できれば1日経って音読するのが望ましいと思っています。音読して、読み詰まる部分があれば、それは恐らく読み辛い文章だと判断します。そして、読みやすいような表現に修正していきます。 そうやって、何度も何度も読み返して修正する内に、とりあえず自分にとって読みやすい文章を作ることができます。それが他人にとって読みやすいかどうかは別問題なのですが、とりあえず、自分だけで出来る努力として、僕は音読を大事にしています。 まぁ、
bukupe.com - bukupe リソースおよび情報
This webpage was generated by the domain owner using Sedo Domain Parking. Disclaimer: Sedo maintains no relationship with third party advertisers. Reference to any specific service or trade mark is not controlled by Sedo nor does it constitute or imply its association, endorsement or recommendation.
はてなグループの終了日を2020年1月31日(金)に決定しました - はてなの告知
はてなグループの終了日を2020年1月31日(金)に決定しました 以下のエントリの通り、今年末を目処にはてなグループを終了予定である旨をお知らせしておりました。 2019年末を目処に、はてなグループの提供を終了する予定です - はてなグループ日記 このたび、正式に終了日を決定いたしましたので、以下の通りご確認ください。 終了日: 2020年1月31日(金) エクスポート希望申請期限:2020年1月31日(金) 終了日以降は、はてなグループの閲覧および投稿は行えません。日記のエクスポートが必要な方は以下の記事にしたがって手続きをしてください。 はてなグループに投稿された日記データのエクスポートについて - はてなグループ日記 ご利用のみなさまにはご迷惑をおかけいたしますが、どうぞよろしくお願いいたします。 2020-06-25 追記 はてなグループ日記のエクスポートデータは2020年2月28
美しい日本語を使いたい、ワンランク上のビジネスメールの作法
「お世話になっております」、「了解しました」、「取り急ぎ、お礼まで」など、ビジネスメールでよく使用する言い回しの間違った使い方、正しい使い方など、ビジネスメールのワンランク上の作法を紹介します。 [ad#ad-2] 下記は、月刊誌「日経おとなのOFF 4月号 美しい日本語」で紹介されている「『美メール』の作法」から、特に気になった箇所をピックアップしてまとめたものです。 日経おとなの OFF 2011年 4月号（amazon） マナー以前のビジネスメールの常識 ワンランク上のビジネスメールの作法 シーン別のビジネスメールの作法 マナー以前のビジネスメールの常識 メールの件名は具体的に 内容が分かる具体的な件名にしましょう。 「こんにちは」「お願い」「なるはやで」は、ダメ。 返信メールの件名は変更しない 同じ議題であれば件名は変更せずに、「Re: 」を付加して返信しましょう。 議題を変更する
読みやすい文章を書くための技法 - RyoAnna
『坊っちゃん』自筆原稿 読みやすい文章とは、流れるように読める文章だ。難しい言葉はいらない。気のきいた言葉もいらない。文頭から文末まで振り返ることなく読める文章が、最も美しい。 読みやすさの基準は客観的なものだ。読み手には様々な人がいる。老若男女すべての人に対して読みやすい文章を書くのは難しい。ただ、綺麗な文章を書こうとする意識は持ちたい。 文章を書く上で意識すべき技法を紹介する。 常体と敬体 常体とは「だ・である」調の文章であり、敬体とは「です・ます」調の文章を指す。それぞれにメリットとデメリットがある。 常体は、自分の意思を力強く伝える事ができるが、我の強い文章になる。敬体は、優しい印象で共感を得やすいが、まわりくどい文章になる。 常体と敬体を織り交ぜて書く手法もある。まずは自分で試してみて、書きやすい文体を見つければいい。 文章の始まりは短く 最初の一文は短いほうがいい。インパクトが
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ulog.cc
http://n1kumeet5.com/2011/08/atamayoibunsyo1/
小論文の添削でしょっちゅう指摘したこと - らいおんの隠れ家