こんにちは。クリエイション開発部の丸山@h13i32maruです。 みなさんドキュメント書いてますか？私はドキュメントを書くのは結構好きです。最近もプライベートで開発しているJasperというGitHub用Issueリーダーのユーザ向けドキュメント（マニュアル）を書きました。でも良いドキュメントを書くのって難しいですよね。 そこで、本記事では「ツールやライブラリなどを対象にしたユーザ向けドキュメント」を書くときに私が考える原則を紹介します。ちなみに私はテクニカルライティングの専門家ではなく、普通のソフトウェアエンジニアです。そのあたりはいい感じに汲み取っていただけると🙏 🕵️メンタルモデルの原則 良いドキュメントとはどのようなものなのでしょうか？私は「そのツールやライブラリに対して読者がメンタルモデルを構築できる」のが良いドキュメントだと考えています。これを「メンタルモデルの原則」と呼

上弦の蒼月、漆黒の時。忘れ去られようとする魔術の伝承をわずかに繋ぎ止める、混沌（ケイオス）に支配された妖術使い達の書き記すインクの瓶が揺れた。 遠くの魔界の果てと呼ばれる、荒涼とした平地、遥か遠くに魔界の城下の明かりがともる。大戦のために集結した魔王（サタン）軍と魔天王軍の足踏み、あるいは人形（ひとがた）ならざる魔界の生物の唸り。それらは緊迫した空気を揺らした。 「とどめを刺す必要は無いよ」 両方の腰脇に、細身の鉄の杖を装備し、深緑色にえんじ色の差し色が鮮やかな法衣に実を包んだユシト＝レディエルはつぶやく。何度も紅玉の杖の持ち手に布を巻き直していたマユミの手に、また汗がにじむ。自分の白地の法衣も、初めて袖を通すが……見た目よりもずっと軽く驚いた。同じ布地で黒に近い紺色をまとうジン＝ジモフ、この3名が、今回の魔界大戦における魔天王勢の魔導師である。魔王勢に魔導師はいない。しかしながら、魔剣士

NTT持ち株会社が2018年5月11日に都内で開催した2017年度決算説明会で、海賊版サイトへのサイトブロッキング実施を公表した経緯について鵜浦博夫社長が記者の質問に答えた。

どうもはらぺこグリズリーです。 いつもこのブログをご覧になってる皆様、本日も来てくださって誠にありがとうございます。 今回は先日出版させて頂いた著書「世界一美味しい煮卵の作り方」についてお話させて頂こうと思います。 世界一美味しい煮卵の作り方 家メシ食堂 ひとりぶん100レシピ (光文社新書)posted with ヨメレバはらぺこグリズリー 光文社 2017-02-15 Amazon 読者の方は既にご存知かもしれませんが、すごくありがたいことに控えめに言って、多くの方にご愛読頂いているようです。 発行部数は現在27万部とのことで本当に驚いております。。 先日は、レシピ本大賞という料理本の中で最も権威のある賞を受賞させて頂きました。 このたびレシピ本大賞を受賞させて頂きました。 自分のような未熟な人間がこのような栄えある賞を受賞させて頂けて、本当に光栄に思います。 読者の皆さまのおかげです

編集者やライターが知見とか現状とかを共有できるといいなとおもって作りました。ギリギリですけど参加してもらえると嬉しいです。

企画／プロット まずは、小説を書く以前の段階です。企画をしたりプロットを書いたりするところです。この段階は大きく分けて、「情報を収集／蓄積する」「情報を整理する」「小説の設計図を作る」の3つの作業に別れます。 情報を収集／蓄積する。 情報を整理する。 小説の設計図を作る。 情報の収集／蓄積 情報の収集／蓄積は、大きく分けて「Webから」「本から」「リアルから」の3種類に分かれます。 Webから 「Webから」の場合は、Webブラウザを使って情報を検索して収集します。私の場合は「Google Chrome」を利用しています。 Google Chrome Webから情報の収集／蓄積を行なうツールには、「Evernote」のような情報集積ツール、古くは「紙copi」のようなツールがあります。 Evernote 紙copi 私の場合は、こうしたツールを利用せず、調べたWebページのタイトルとURL

先日、ある新人漫画家さんから「連載を開始するにあたって、一般的な原稿料の相場や、必要な契約関係書類を知りたい」というご相談をいただきました。業界の常識がわからない状態で、どんなことをどこまでを出版社に要求していいのか知りたいようでした。 お会いして、僕なりにいろいろとお話させていただいたのですが、これから漫画家として活動をしていこうとする方々にとって必要な情報かと思いましたのでまとめてみます。 まず、一般的な原稿料の相場。 10年前に比べて相場は下がっています。 すべての出版社の原稿料の相場を知っているわけではないので、確実なことは言えませんが、中堅出版社でも新人原稿料1ページあたり5000円（しかもカラー連載）という話は聞きますし、10年前から平均1000円以上は下がっているのではないでしょうか。 以前は雑誌連載の場合、新人の原稿料は7000円くらいが最低でしたが、今は5000~6000

ちょっとしたことでも雑にブログに書いておくと良いことが起こる - $shibayu36->blog; で、ちょっとしたことでも雑にブログに書いておくと良いことが起こるよということを書いた。さらに余談として最低限の雑さについても書いた。 これをきっかけに、公開の場でアウトプットする時の最低限の雑さとはなんだろうという疑問が自分に生まれ、雑さによる問題や、それを引き起こさないようにするための自分の工夫について少し頭がまとまってきたので、自分の考えを書いておく。 過度な雑さから生じる最大の問題 まずあまりにも雑に公開の場に書いてしまった場合の最大の問題について考える。この時、一番起こってほしくない問題は、「読み手が誤った情報を正しい情報と信じてしまう」ことだと考えた。 あまりにも雑な文章は読み手の誤認を引き起こし、正しい情報ではないのに正しいと読み手が解釈してしまう問題がある。正しいと解釈してシ

2016年は Medium にとって忘れられない1年となりました。Medium の Japan コミュニティは驚くほどに成長し、毎月数百のストーリーが日本語で投稿されるまでになりました。 年初に各種メディアでアナウンスさせていただいた記事を既に読まれた方もいらっしゃると思いますが、Medium はこれまで以上に利便性の高いプラットフォームの実現に向けていくつか戦略上の変更を施すこととなりました。 Japan 含めて10カ国以上で Medium の運営を続けてきましたが、本年よりすべてのオペレーションを本社であるサンフランシスコに集中させることにしました。そのため、これまで2年に渡って運営、キュレーションしてきた Medium Japan の各公式パブリケーションや公式 Twitter、公式 Facebook の運用を本日を持って止めることを決定しました。

芝村裕吏氏は、最新作「エレメンタル・ローズ」をはじめ、「マージナル・オペレーション」シリーズ、「セルフ・クラフト・ワールド」シリーズなどの小説で知られる作家さんだ。「刀剣乱舞-ONLINE-」の世界観監修や脚本に参加したゲームデザイナーでもある。古くは「高機動幻想ガンパレード・マーチ」と関わる無名世界観などから追いかけ続けているファンも少なくないはずだ。 過去のツイートも見ると、小説・脚本などの執筆に「ポメラ」シリーズを利用しているヘビーユーザーのようなのだが、はたして「ポメラ」DM200でそんなにも稼げるのだろうか？ 作家さんに数千万稼げそうと言わしめる魅力はどんな点なのか？　そこが気になり、芝村裕吏氏にインタビューさせていただいたのだ。 「累計で5000万円くらい儲かった！ キングジムさん、ありがとう」 —— Twitter上で「新型ポメラ。これで5,000万円を二、三年で稼げそう。」

Evernoteが今週、プライバシーポリシーを更新する予定であることをひっそりと発表した。サービスを向上するためという名目で、Evernoteの社員の一部がユーザーのコンテンツにアクセスし、内容を確認することを可能にするものだ。 同社は「プライバシーポリシーの更新に関するお知らせ」の中で、ノートを含むユーザーのデータをどのように扱うかを説明した。また、今回の更新は「弊社の機械学習テクノロジーが正しく機能していることを確認することが目的」だとしている。 Evernoteの「機械学習テクノロジー」には、自然言語による検索など、人工知能（AI）的な機能が搭載されているようだ。 今回のプライバシーポリシーでは、ユーザーのデータにアクセスできる一部のEvernote社員に対し、「身元調査を行ったうえで、最低でも年に一度（中略）セキュリティ・プライバシー研修を実施」するという条項が追加されている。 ユ

はじめに この記事は「子供/保護者」×「オンラインコミュニケーション」 Advent Calendar 2016の12日目の記事です。去年に続きお声がけいただき、 id:hanazukin さんありがとうございます。ていうか、毎年そうそうたる面々でほんと参加してていいのかと小一時間自問自答です。前の日なんかよしだせんせいやで！！！！！ ことしは「子供OR保護者++オンラインコミュニケーション」ということで、ぼんやりいろいろ最近考えていたことを書いてみます。たぶんたまたま、あの事件というか、アレがあって、ちょっとそのへんの感想も含みますがすみません。 アップデートされ続ける「しごと」 星の数ほど、たくさんの仕事（職種）があります。それらはどんどん細分化していて、さらにパソコン・ネット・スマホ・タブレットの普及によって、いろんな人がいろんな関わり方で、仕事にタッチしています。 特に、オンライン

今日は時間がないのですが、取り急ぎ宣伝ですよ。 特集3「Ubuntuで動かすインクジェットプリンター」を書かせていただきました。 細かいフォローをしたいところもあるのですが時間がないのでそれは後日。狭いワンルームマンションにインクジェット複合機4台配置して原稿書きするのはちょっと大変でしたが、ライターあとがきにも書いたとおり、久しぶりに色んなプリンターをいじれて楽しかったです。 書きましたついでにもう一個、ここで紹介してなかったもの。 こんな本も書いてました。実は。 この本についてもまたいろいろフォローしたいことがあるんだけどまた別途。ちゃんと調べてないけど、MongoDBのRubyドライバーの今のインターフェースについて日本語で解説した書籍ってこれ以外にあるのかなあ。 別に買ってくださいというつもりはないですがご購入いただけるのであればアフィリンク使ってもらうと大変に喜びます。

プログラムを書く傍ら、12年ほど小説を書き続けて作家デビューが決まりました。こうした異業種参入の挑戦は、他の技術者の方にも参考になると思います。というわけで、「プログラマー的アプローチでの小説執筆」「執筆手順とプログラマー的ツールの使い方」の2点について、情報を共有したいと思います。 プログラムと小説 いつもは『マンガで分かるプログラミング用語辞典』を描いている、クロノス・クラウンの柳井です。松本清張賞の最終候補に残った私の小説が、文藝春秋から『裏切りのプログラム　ハッカー探偵 鹿敷堂桂馬』として、8月27日に出版されました。 実はプログラムやその解説書などを書きながら、12年ほど小説の新人賞に投稿を続けていました。そして50作以上書き、試行錯誤していました。その間、プログラマーならではのアプローチで、新人賞の攻略に挑んでいました。 結局、賞を取れずにデビューとなりましたが、「プログラミン

2016年8月24日，ゲーム開発者向けイベント「CEDEC 2016」が，今年もパシフィコ横浜にて開幕した。ゲーム開発に関する最新動向をいち早く吸収できるイベントだが，技術的な話題だけではなく，マーケティングやローカライズ，開発者のキャリアアップなど，幅広いテーマで講演が行われている。 蛭田健司氏（ヤフー PSC事業戦略室 エグゼクティブプロデューサー） 筆者が聴講した講演「夢の印税生活!? ゲーム開発者が本を出版するためのノウハウ」は，ヤフー PSC事業本部の蛭田健司氏によるものだ。ヤフーに勤めながら業界向けの本「ゲームクリエイターの仕事 イマドキのゲーム制作現場を大解剖！」（Amazonアソシエイト）を執筆した経験のある氏が，書籍執筆の経験やノウハウを受講者と共有するという，CEDECでもなければなかなか聞けそうにない内容である。 ちょっと変わったこの講演の概要をレポートしよう。 5本

ここ数日が色々と大変だったので備忘録的に書いておこうと思います。 個人的な話なのであっちのに書くわけにはいかないし、主にこれについて書く。 愚痴みたいなやつなのであんまりシェアはして欲しくないかもしれません。 普段僕をフォローしてる人達だけに読んで欲しいな、って感じ。 bylines.news.yahoo.co.jp 【なぜYahoo!ニュース個人で書いたか】 そもそも、「よし、書くか！」と思ってtwitterで「書きます」って宣言したのは良いけど、宣言してからもあちこちから色んな話が飛び出して来て、気付いた時は「火中の栗」どころかドロッドロに溶けたマグマに手を突っ込むような勢いになってて「延焼まったなしやんけこれ……！」と驚愕しました。 しかしながらそれだけ多数の人の注目を集めているという事の証左でもありますので、まず最初に書く媒体の候補として考えたのが有料noteです。 例えば、 そん

作家・藤井太洋さんは『Gene Mapper -full build-』（ハヤカワ文庫JA、2013年）、『オービタル・クラウド』（早川書房、2014年）をはじめ、多くの長編作品を執筆し、伝統ある賞も獲得されています。藤井さんはこれまでさまざまなアプリケーションを試してきたとのことですが、最終的にはScrivener［★1］を使って小説を執筆されています。今回、藤井さんに、執筆時に使用するツールを中心にお話しいただきました。ツールを選ぶポイントや、ツールの構造から知る英語圏の文学事情など、「執筆」と「ツール」の間で広がる話題を是非お楽しみください。 この記事は、『考えながら書く人のためのScrivener入門 小説・論文・レポート、長文を書きたい人へ』（ビー・エヌ・エヌ新社、2016年）収録のインタビュー「小説家・藤井太洋氏に聞く、Scrivenerの使い方」を再編集したものです。 ★

オープンソースからハイスクールフリート、The Beatlesまで何でもありの自称エンターテインメント日記。 おお、今気づいたけど表紙の"x"が被ってるんですね！ 14.04のときにも別冊付録を執筆したのですが、そちらは編集さんに明確なビジョンがあったのでそれに乗っかりました。 こちらは私が目次出し・執筆・再録の掲載記事のピックアップと全面監修(一部手を入れてる)を行いました。超頑張りました。何せ極厚100ページですからね。ちなみに本誌は156ページですからね。 新規描き下ろし部分は全体の1/3で、 ・巻頭言 ・Ubuntu 16.04 LTS 10大変更点 ・Ubuntu再入門 ・最新Ubuntuをインストールしよう ・Ubuntuの基本操作ガイド です。『Ubuntu再入門』は、Ubuntuとはなんぞやというのを可能な限りコンパクトにまとめて書きました。それでも12ページあるのですけど