「大江戸Ruby会議10」での発表資料です。 https://regional.rubykaigi.org/oedo10/

テクニカルライティングの基本を学べます。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。サイボウズの2023年度 新入社員向け研修の資料です。 本資料をもとにした書籍も発売中です：https://amzn.asia/d/2hQNEk2 Twitter：http…

リンク 「美文字の書き方」の基本を覚えましょう！｜ 「美文字の書き方」の基本を覚えましょう！ 【美文字の書き方】キレイな字を書くためのポイントは、たくさんあります。すべてを説明することはとてもできませんので、「これだけはマスターしてほしい！」という美文字のポイントを３… 3 users 8

ChatGPTは「手前の文に確率的にありそうな続きの文字を繋げるAI」 まず最初にChatGPTの仕組みについて。 深津さんによるとChatGPTは、「手前の文に確率的にありそうな続きの文字をどんどん繋げていくAIである」とのこと。 例えば「昔々」という入力に対して、確率的にありそうな続きの文字は「あるところに」であるという具合に、続きそうな文字をただ出してくれるAIなんだそうです。 これを誤解していると求めているような回答がなかなか得られないので、ChatGPTに自分が求めている回答してもらうためには、確率的にありそうな続きの文字を出す方向性を狭めていくような質問をする必要があるそうなんですね。

今年35周年を迎え、12月9日（金）には劇場映画「映画 かいけつゾロリ ラララ♪スターたんじょう」も公開される大ロングセラー「かいけつゾロリ」シリーズ。12月7日（水）発売の『かいけつゾロリきょうりゅうママをすくえ！』でなんと72冊にもなる大シリーズの作者、原ゆたかさんはどのように物語と絵をかかれているのでしょうか。制作秘話を伺いました。 児童書作家になったのは？　私は『ちいさなもり』（1975年／フレーベル館刊）という自作の絵本は作っていましたが、元々は作家ではなく、他の作家さんの書いたお話に絵を描く画家でした。 子どものころから絵を描くのが好きで、ずっと描き続けていましたし、映画も好きだったので、絵本や児童書ならば、お話を絵で演出することができると考えて児童書の画家を目指しました。 当時は、児童書の挿し絵というと、一般的には出版社から指定された場所に絵を描くスタイルでした。でも、私は限

こんにちは。iQeda [@iQeeeda] です。 新しいプロジェクトにジョインしたら、チームの Git 運用ルールを頭に入れると思います。 技術的に尖っている現場だと、最初のコミットはちょっと緊張しますね… そんな僕が今まで遭遇した (調べた) コミット運用方法をまとめてみました。 紹介する prefix や 絵文字を使ったコミットメッセージ運用は最近よく使われています。

相手に誠実に、わかりやすい文章を書くための心がけをまとめました。 どういう思考プロセスからどんな表現が生まれるのか、参考として実例を紹介しています。実際に読み比べ、SmartHRの従業員として何かを伝えようとするときの、参考にしてください。 伝わる文章のガイドライン何を伝えるかによって、必要な情報の量や説明の粒度は異なります。 情報が不足していたり、逆に情報が多すぎたりすると、読者が意図を読み取れないことがあります。 読み手となる相手の状況（読む場面、事前知識など）を踏まえ、言葉にする内容や表現を厳選することが大切です。 目的に合わせて情報を取捨選択する読者の目線に立ち、コンテンツの目的に合わせて情報を取捨選択しましょう。 実例1：法律や業務に関わる記事目的業務に関係する「厚生年金保険」について正確に知りたいと思っている人に、わかりやすく内容を伝える。 Before日本の年金制度は、全国民

下記ドキュメントバージョンに関する注意点です。 バージョン番号のルールを定める：バージョン番号は、どのようにつけるかルールを定め、チーム全員が同じ理解で使用するようにする必要があります。たとえば、変更内容によって数字がどのように増えるか（major, minor, patch）、何桁で表現するかなど、具体的に決めておくことが重要です。 変更履歴を明確にする：どのような変更があったのか、それがどのバージョンで実施されたのかを明確にすることが必要です。これにより、何らかの問題が発生した場合に、どのバージョンから問題があるのか特定することができます。 ドキュメントの保存場所を一元化する：ドキュメントのバージョン管理には、ドキュメントを保存する場所を一元化することが重要です。それにより、異なるバージョンのドキュメントが、複数の場所に分散してしまい、誤ったバージョンが使用されることを防ぐことができま

漢字と平仮名の使い分けなどが記載されたハンドブックを入手したので、ご紹介します。文章を書く方には特にお勧め！ ブログなどの文章を書いていると、早かれ遅かれ、漢字と平仮名の使い分け問題にぶち当たると思います。 例えば、「行く、いく」などの本動詞・補助動詞であったり、「事（こと）、所（ところ）」などの形式名詞、「と言う、という」などの実質的な意味が薄れたものや、「所以、ゆえん」などの難しい漢字・常用外漢字などです。 これらは気になりだすともう切りがないのですが、この使い分け問題をなんと一発で解決してくれる本があるので、今回はそんな文章を書く方は必携のハンドブックをご紹介します。 新聞用字用語集『記者ハンドブック』第13版学校教育などでは、「漢字にできる文字は漢字で書く」と教わってきた方も少なくはないと思います。かく言う私もその1人で、漢字こそが正義だと思っていた時期もありました。しかし、文章を

テクニカルライティングの基本を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 Twitter：https://twitter.com/naoh_nak 2023年度のアップデート版もあります：https://spe…

コーディングを勉強している方や、普段当たり前のようにコーディングしているけれど、上手く使えているのか不安な方向けにGoogle HTML/CSS Guideの翻訳記事を書きました。（2024年02月29日更新） 色んな方のコーディングを見ていると実に様々。情報や知識が古いままで、今では推奨されない書き方も散見されます。 特に仕事で使っていると、誰かに指摘されない限り自分のコーディングを見直す事は無いかもしれません。 ですがW3Cの定めたHTML5の廃止など、変化の速い業界では定期的な見直しは勿論、何か指標となる物があると安心です。 そこで今回はGoogleが用意しているgoogle html/css style guideのドキュメントを元に、Googleコーディング規約と要点を解説。このコーディングガイドラインが絶対的な正解では無いかも知れませんが、参考になれば嬉しいです。 Google

中村明博（編集者） @naka727 【編集者からのお願い】 著者やライターさんへ、原稿が完成したら、 ・「という」をカット ・「と思います」をカット ・「こと」をカット ・「もの」をカット ・過剰敬語をカット できないか見直していただけないでしょうか。ざっとでもかまいません。関係者全員が幸せになります。なにとぞ、、！ 中村明博（編集者） @naka727 【なぜこんなお願いをするか】 誰かが直さなければならないからです。その分、「磨き上げ」の時間が減り、本のクオリティーが落ちます。本の売り上げが落ち、関係者全員が不幸になるためです。 中村明博（編集者） @naka727 さらに可能なら、 ・40字を超える長文は短く・簡潔にする ・「これから説明します」的な余計な前置きはカット ・「ひとつ・1つ」「ひとり・1人」あたりの表記統一を行う このあたりまで見ていただけると、編集者はみな泣いて喜び

LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま

こんにちは、Choimirai School のサンミンです。 【主要なアップデート】 （2023.10.01）ベゾス氏がパワポを禁止した理由を語った動画を追加 （2020.05.11）Blitzscaling、ビル・ゲイツのコメントと英語版リンクを追加 （2020.05.11）知的生産の技術に関するコメントを追加 0  はじめに ▲アマゾンの社内プレゼンテーションで、パワーポイントの使用が禁止されているのは、かなり有名な話。 会議では、冒頭のおよそ15～20分間、参加者全員にドキュメントを読むための時間があてられる。ドキュメントは６ページと長い場合も多く静まったミーティングルームで参加者が黙々とドキュメントを読む雰囲気はかなり緊張感が漂っている。

と思っている話です。もはやタイトルでぜんぶ言ってしまった。 せっかくなのでもう少し続けます。 2020/05/03追記：第二弾？書きました この本がまだ初稿になる前、共著者のみなさんと執筆真っ最中の頃に何度か打ち合わせがあったのですが、そこで「書籍的な文章を書き慣れてない人って、"という"と"こと/もの"を多用しがちなので、この2つを抑えるだけでも文章がシュッとするんですよ」とお話したら思ったより反応があったので、これは需要があるんじゃないかと感じたのがきっかけです。 ここから先は具体例を交えて解説していきます。 さすがに他人様のテキストを使うのは気が引けるので自分が書いた記事を例に挙げます。……でも自分はこのテクニックを使うようにしているので、該当する記事がなかなかないんですよねぇ……と思ったらあった！ （よりによってこれか……せっかくなので皆さんスタァライトを観ましょう！） 記事中では

やたらとインプットとアウトプットをたくさんやっているのに、なんだか、言っていることが表面的で、ちっとも面白くない人がいる。 そういう人はたいてい、「アウトプット」はやってるけど「活用」を疎かにしている。 たとえば、「良い文章の書き方」の本を読んだら、そういう人は、単に「良い記事の書き方」のまとめ記事を書く。そして、それを「アウトプット」と言っている。 しかし、これでは、知識は血肉にならない。 血肉になっていない知識は、畳の上で練習した水泳のようなもので、いくらやっても泳げるようにはならない。 インプットした知識を血肉にするには、インプットした「良い文章の書き方」のテクニックを使って、自分のオリジナルの文章を書く必要がある。 つまり、インプットした知識をそのまま出力するだけではダメで、その知識を使って、具体的な何かをしないと、血肉にならないのだ。 アウトプット ＜＜＜｜越えられない壁｜＜＜＜

先日、東洋経済さんでこんな記事を拝読しました。 ｢作文｣が書けない子に教えたい3つの言葉 文章を書くことは、観察し、驚きを見つけ、考えることです。これがステップ1からステップ3への手順に当てはまるのです。 （東洋経済オンライン） 正直なところ、この記事を書いた方は「作文が書けない子」のレベルをかなり高く見積もっているなあ、と感じました。 いや、文中のテクニック、文中の手法が悪い、というわけではないのです。ここに書かれていることは、それはそれで非常に有用、非常に有効なことだと思います。 「観察→深堀りと整理→考察」という思考法は、あらゆる表現、あらゆる論考で重要な手順です。 小さい頃からこの手順になじんでおくことはとても有益ですし、その際の教え方、かみ砕き方として、文中提示されているような言い方をするのも有効でしょう。そこについては何の文句もないんです。 ただ、ここでいう「作文が書けない子」