タグ

writingに関するfukkenのブックマーク (53)

  • ドキュメント作成スキル向上を目指す人向けおすすめ記事まとめ - Qiita

    システム開発にドキュメントは欠かせません。ドキュメントが得意になれば活躍の幅が大いに広がりますよね。 この記事では、まず冒頭でドキュメントの作成に求められると思うことを整理した上で、そのスキル獲得に役立つと思われる記事や書籍を集めてみました。もちろん他にもあると思うので、もしお薦めのものがあれば是非コメントで教えて下さい 更新履歴 ・2021/04/16:文章術系にリンクを追加しました。 ・2020/11/28:文章術系にリンクを追加しました。 ・2020/07/24:文章術系にリンクを追加しました。 ・2020/05/24:文章術系にリンクを追加しました。 ・2020/05/14:スライドデザイン系にリンクを追加しました。 ・2020/04/29:スライドデザイン系にリンクを追加しました。 ・2020/04/17:文章術系にリンクを追加しました。 ・2020/04/12:関連するTwit

    ドキュメント作成スキル向上を目指す人向けおすすめ記事まとめ - Qiita
  • https://jp.techcrunch.com/2017/09/08/20170907google-publishes-its-documentation-style-guide-for-developers/

    https://jp.techcrunch.com/2017/09/08/20170907google-publishes-its-documentation-style-guide-for-developers/
  • 今日から使える文章校正テクニック | DevelopersIO

    渡辺です。 昨日のエントリーが結構反響大きめだったので、第二弾です。 文章校正をしていてよくあるパターンを幾つか抽出してみました。 ただし、前回紹介しているパターンは除外していますので、あわせて確認ください。 重複を減らす 文章校正の基礎は 重複を減らす ことです。 次の文章を見てみましょう。 AWSを使い慣れている人にとっては簡単な作業ですが、使い慣れていないと戸惑う所も多いところです。 この文章がくどく感じる理由は、「使い慣れている」が重複していることです。 前後関係もありますが「ところ」がなにを指しているのかも曖昧ですね。 後半の「使い慣れている」を削除し、バランスを取るために作業を後ろに移動しました。 さらに、前の文章を受けるため、「これは」を追加します。 これは、AWSを使い慣れている人にとっては簡単ですが、そうでないと戸惑う作業です。 スッキリしました。 しかし、「慣れていると

    今日から使える文章校正テクニック | DevelopersIO
    fukken
    fukken 2017/06/28
    文を限界まで短くして、できるだけ意味の明確な接続詞を使う事は心がけてる。特に翻訳に回したりする場合、日本語の段階で文の精度を上げる方が良い
  • 明日の4Gamerを支えるライターは君だ! 6年ぶりとなる「4Gレビューコンテスト」を開催します

    明日の4Gamerを支えるライターは君だ! 6年ぶりとなる「4Gレビューコンテスト」を開催します 編集部:ginger 4Gamerは日(2013年10月1日),過去に8回くらい行われた「4Gレビューコンテスト」を6年ぶりくらいに開催し,その作品募集を開始する。これは,その名のとおりゲーム/ハードウェアのレビュー作品を募集し,4Gamer編集部が審査を行うというコンテスト。優秀な作品は4Gamerに掲載すると共に,規定の原稿料をお支払いする。また受賞者が望めば,その後も引き続き4Gamerから仕事を発注させていただくことにもつながるというものだ。 今回は,「PCゲーム部門」「PCオンラインゲーム部門」「コンシューマゲーム部門」「スマホアプリ部門」「周辺機器部門」「モバイルデバイス部門」の,計6部門での作品募集を行う。つまり,どういうことかと言うと,日ごろ4Gamerで目にするような“ゲー

  • レポートの書き方 (スタディ・スキル) [北大 アカデミック・サポートセンター]

    注意 以下はレポートと論文などを作成するためのよくある質問と一般的なアドバイス集です。講義中に教員からの指示がある場合は,必ずそちらに従ってください。また,万が一このFAQsを利用することで不都合が起こったとしても,制作者は責任を取りかねますので予めご了承ください。 レポートの提出用紙はどうしたら良いの? 特に指示がなければ,A4サイズの紙を使ってください。上質紙,リサイクル紙など,種類は特に気にしなくても結構です。紙は白,あるいは白に近い淡色のものを使用してください。手書きの場合も,指定がなければ原稿用紙,レポート用紙,無地の白紙など,何を使用しても問題はありません。ただし,極端に色の強い紙や,失敗コピーやスーパーのチラシなどの裏面に文字が書いてあるようなものは用いてはいけません。 余白や文字数,行間の取り方などについて,手書きの場合は読みやすさを考えて適宜調整してください。PCの場合は

  • スタイルガイド|JTF 日本翻訳連盟

    『JTF日語標準スタイルガイド(翻訳用)』は、実務翻訳において和訳時に使用できる日語表記ガイドラインです。2012年1月30日に初版を公開しました。『JTF日語標準スタイルガイド』はどなたでも無償で使用できます。日語の表記のゆらぎを防いで、スムーズに表記を統一するためのガイドラインとして活用してください。著作権および使用条件は文書体に記載しています。

  • インタビューズに答えていると、好きな話以外でもどつい長文になってしまいます。削ってシンプルな短文にするコツなど教えてください。 - とみさわ昭仁インタビュー

    ザ・インタビューズに限って答えます。 1, 主語を取る(主語は自分にほぼ決まってるので) 2, 質問を読んでから、短くとも三時間は間をあける(冷静になる) 3, 「〜なんだけど」っていう文章があったら、なるべくその前の部分は削る 4, 質問者はともかくとして、読む人はそんなに自分には興味がないものだと自覚する 5, 相手を信じる おれは駆け出しのライター時代に少年ジャンプ仕事をさせてもらったおかげで、ジャンプ流のものの書き方をずいぶんと叩き込まれた。それはどれもこれも有意義で、いまも役に立っているけど、ひとつだけ違和感があったのは「読者はバカだと思え」ということだ。 読者はバカなんかじゃないよ! 読者を信じられなくて、なんでなんか作っていられるんだよ! たしかに、駆け出しの頃は、読者をバカだと想定して、どんなバカにでもわかるような文章を書くことはものすごい文章修行になっ

  • http://n1kumeet5.com/2011/08/atamayoibunsyo1/

    fukken
    fukken 2011/08/17
    まあ基本的 // 「推敲して誤字脱字を探す」を追加で。
  • 求人情報はしっかり書けや

    今、海外IT系企業に所属しているのだけど、日の求人情報のいい加減さにはうんざりする。あれで人を集めたいと良く思うな。部下というより、子分が欲しい感ありあり。結構有名な人でもそういうことをするんだよな。「一緒に未来を目指せる人」とか一行もいらない。 海外じゃ、あれは通用しない。元々スキルも出生もバラバラな人を雇う前提なので、事前の要望を明確にしておかないと、採用活動自体が無駄になるから。LinkeInとかが、スキルと経験をきちんと書けるよう設計してあるのも、そのため。日の求人ではグローバルは目指せない。 以下に、(自分視点だけど)望ましい例をあげる。 経験、スキル ○○経験n年以上 所属していた部門、業界の経験年数をあげておく(「マーケティング」「ゲーム業界」など)。普通は3年とか、2年とか。業界の標準知識を持っている事を計るため。部門のリーダーなら、5年以上でもいいでしょう。 ○○に関

    求人情報はしっかり書けや
    fukken
    fukken 2011/08/12
    "要するに「書かなくてもわかるだろ」を意地でもはっきりさせるということ"
  • IDEA * IDEA

    ドットインストール代表のライフハックブログ

    IDEA * IDEA
    fukken
    fukken 2011/05/24
    「安心して読める」「行動をしたくなる」「共有したくなる」という3つの基準
  • 分かりやすい提案書はアウトラインが美しい

    分量がある文書を作成する際には、文書全体の「アウトライン(骨格、構成)」をきちんと作り上げてから内容を記述する必要があります。今回は、「読みやすく分かりやすい提案書」にするアウトラインの作成方法について紹介します。 読みやすい文書は「階層構造」をしている 読みやすい、分かりやすい文書は、全体が階層構造になっています。文書は、一般的に下記のような階層で構成されています。 大見出し(章) 中見出し(節) 小見出し(項) 階層構造は、複雑で大量の情報を含んだ文書の内容を、分類・整理するために必要不可欠です。階層化した文書は、各トピックで記述される範囲が決まっているため、焦点を絞って読むことができます。このことは、読者の理解を大いに助けます。 階層構造の方法について、順を追ってみていきましょう。まず「大見出し」の層に分割します。その後に各「大見出し」を「中見出し」の層に、さらに必要であれば「中見出

    分かりやすい提案書はアウトラインが美しい
  • システム開発を成功させたいSEに送る、「文書執筆のおきて」まとめ

    システム開発を成功させたいSEに送る、「文書執筆のおきて」まとめ:誰にでも分かるSEのための文章術(15)(1/2 ページ) 「提案書」や「要件定義書」は書くのが難しい。読む人がITの専門家ではないからだ。専門用語を使わず、高度な内容を的確に伝えるにはどうすればいいか。「提案書」「要件定義書」の書き方を通じて、「誰にでも伝わる」文章術を伝授する。 文書を記述するに当たって、常に意識しておかなければならない点が4つあります。 システム開発における文書の重要性を認識する 読み手のことを考える 文書の構成を作ってから、文書作成に取り掛かる 必ず読み返す これらは、分かりやすい文書を作成するための基ポリシー、“おきて”とでもいうべきものです。連載の最終回となる今回は、文書作成時に常に意識しておきたい「文書執筆のおきて4カ条」について解説します。 その1:システム開発における文書の重要性を認識する

    システム開発を成功させたいSEに送る、「文書執筆のおきて」まとめ
  • 出版社から出ることで同人誌はどう変わったか? - ヴィクトリア朝と屋敷とメイドさん

    はじめに 『英国メイドの世界』へのAMAZONレビューでいただいた「平易で十全」や「今までにあった家事使用人研究のどの文献よりも読みやすい」と評価していただけたことは、自分にとって響くものでした。同人誌から品質を上げていく際、講談社BOX編集部と共に最もこだわった部分だからです。 読者の方には「読み、感じたことがすべて」です。制作側の意図は評価対象となりませんが、「同人版との違い」「出版社で出すことで得られたこと」を自分として確認する目的で、以下に今回の講談社BOX版で目指した「読みやすさ」を実現するために何をしたかを記します。 『英国メイドの世界』は2つの意味で、私がこれまで多くの研究書を読む中で感じたことや、同人誌を作る中で研鑽したことを踏まえた理想を追求しました。 ・1.日に存在しないでかつ、初心者だった頃の自分が読んで楽しめる ・2.物理的に読みやすく、読んだ内容が頭に残るこ

    出版社から出ることで同人誌はどう変わったか? - ヴィクトリア朝と屋敷とメイドさん
  • レポートや企画書、メールの文章を上達させる9つの方法

    by Jesse Draper 文章を書く場面というのは意外と多く、レポートや企画書、またメールの文面などがなかなか書けず悩んでしまうこともあるのではないでしょうか。そんな人にぜひ読んでほしい、文章力を鍛えるにあたって有効な9つの方法が紹介されています。 内容は特別なテクニックではなく、これを行えば自然と文章を書く力がアップするという方法ばかり。文章の書き方のワークショップなどで学ぶのもいい方法ではありますが、それが難しい場合でも、1人でできるトレーニング法が紹介されています。 文章力アップのためのポイントは以下から。Effective Tips to Improve Writing Skills | Maypalo ◆写真に説明文をつける まずは「写真をじっくりと観察し、その写真を説明する文章を書く」というもの。写真には何が写っているのか、どこが面白いと感じたのか、その写真は光がどちらか

    レポートや企画書、メールの文章を上達させる9つの方法
  • エロゲーライター時代の思い出話

    エロゲーライター時代に経験した思い出話。 タイトル名は特定しないでください(爆。 当はドラマチックストラクチャーのマルチエンディングへの適用をどうやるかをツィートするつもりだったのですが、思いっきり道をそれてしまいました。

    エロゲーライター時代の思い出話
    fukken
    fukken 2010/09/30
    プロすげええええ
  • Webを活用したマニュアルの役割とは

    先週、新宿で開催されたテクニカルコミュニケーションシンポジウム2010にて、パネルディスカッションのパネラーとして参加させていただきました。Web技術やデザインに関連する話ではなく、ネット社会のいまとマニュアルのこれからを考えるという内容でした。マニュアル(テクニカルライティング)という世界はあまり詳しくありませんでしたが、出演のオファーをいただいた2ヶ月前から調査・勉強をし、このサイトでも紹介しているような情報を交えて話に加わりました。 そもそもマニュアルとは? 電子書籍でもハマる問題ですが、今までのマニュアルの見た目・印象を活かしつつ電子化してしまうと、紙のように見えて紙ではないよく分からないデジタルマニュアルになります。「よりリッチに」ということでインタラクティブなコンテンツが盛り込まれた CD-ROM が同封される場合もあります。しかし、そんな形ではマニュアルの電子化に未来はありま

    Webを活用したマニュアルの役割とは
  • 読みやすい文章を書くための技法 - RyoAnna

    『坊っちゃん』自筆原稿 読みやすい文章とは、流れるように読める文章だ。難しい言葉はいらない。気のきいた言葉もいらない。文頭から文末まで振り返ることなく読める文章が、最も美しい。 読みやすさの基準は客観的なものだ。読み手には様々な人がいる。老若男女すべての人に対して読みやすい文章を書くのは難しい。ただ、綺麗な文章を書こうとする意識は持ちたい。 文章を書く上で意識すべき技法を紹介する。 常体と敬体 常体とは「だ・である」調の文章であり、敬体とは「です・ます」調の文章を指す。それぞれにメリットとデメリットがある。 常体は、自分の意思を力強く伝える事ができるが、我の強い文章になる。敬体は、優しい印象で共感を得やすいが、まわりくどい文章になる。 常体と敬体を織り交ぜて書く手法もある。まずは自分で試してみて、書きやすい文体を見つければいい。 文章の始まりは短く 最初の一文は短いほうがいい。インパクトが

    読みやすい文章を書くための技法 - RyoAnna
  • 小説としての体裁と構造をどう構築するか

    作家の榊一郎さん(@ichiro_sakaki)のプロットの構成に関する呟きから始まり、小説を作成する上での文章の書き方や、物語の構造を把握することの重要性などをまとめました。私用ですので、欠けているところが多々あります。

    小説としての体裁と構造をどう構築するか
  • エンジニアのための文章の書き方入門 – 秋元

    なるほど。と思ったのでメモがてら和訳。 How to make engineers write concisely with sentences? By combining journalism with the technical report format. In a newspaper article, the paragraphs are ordered by importance, so that the reader can stop reading the article at whatever point they lose interest, knowing that the part they have read was more important than the part left unread. エンジニアに簡潔な文章を書かせるには? ジャーナリズムと技術レポー

    fukken
    fukken 2010/04/07
    おお、ミントのピラミッド・ストラクチャー( isbn:4478490279 )そのものだ
  • さらば、翻訳調の文章! 技術者向け校正ルール

    さらば、翻訳調の文章! 技術者向け校正ルール:誰にでも分かるSEのための文章術(8)(1/2 ページ) 「提案書」や「要件定義書」は書くのが難しい。読む人がITの専門家ではないからだ。専門用語を使わず、高度な内容を的確に伝えるにはどうすればいいか。「提案書」「要件定義書」の書き方を通じて、「誰にでも伝わる」文章術を伝授する。 第7回「専門用語は徹底的に「読み手指向」で書くべし」に引き続き、「語句の使い方」や「表記法」を解説します。今回は、技術者の文章にありがちな癖、「翻訳調」「漢字の多用」を、より読みやすい文章に修正する方法を提案します。 SEは、翻訳書・文書を読む機会が多い仕事です。専門書や技術書、開発業務を進める際の文書類を、英語の原文で読むこともしばしばあります。そのせいか、翻訳調の文章を記述してしまいがちです。 翻訳調、特に直訳調の表現は冗長です。読みにくいので使わないようにしまし

    さらば、翻訳調の文章! 技術者向け校正ルール