HRBrain Advent Calendar 2023 1日目の記事です。 はじめに こんにちは。@yug1224(Yuji Yamaguchi)です。 今年もAdvent Calendarが始まりましたね！そろそろ記事を書かなきゃと焦っている人も多いのではないでしょうかｗ 本記事では、私が文章作成時に気を付けているテクニカルライティングの観点と、そのために使っているtextlintのルールを紹介します。 テクニカルライティングとは テクニカルライティングとは、技術的な内容を正確かつ効率的に伝えるために誕生した文章作成技術です。 コンピューターやICT技術の発達により、今ではあらゆる職種の人に文章を書く機会があるため、テクニカルライティングの技術はビジネスパーソンにとって必須の技術となっています。 オススメ書籍 テクニカルライティングに関する書籍や記事はたくさんありますが、私は以下の書籍

ガジェット全般、サイエンス、宇宙、音楽、モータースポーツetc... 電気・ネットワーク技術者。実績媒体Engadget日本版, Autoblog日本版, Forbes JAPAN他 米CNETは先週、昨年11月から公開されてきた一連の金融知識の解説記事を、AIで生成していたことを明らかにしました。 それまでは、著者名が「CNET Money Staff」とされ、あたかも人間のライターが書いているように見えていたものの、他のメディアなどから批判が相次いだこともあり、CNET編集長のConnie Guglielmo氏は、記事をAIで生成する実験を行っていると述べ、その理由を説明する記事を公開しています。 CNETは、AIによって生成された記事はすべて人間のスタッフが「レビュー、事実確認、編集」していると主張しています。しかし米国のテクノロジー系メディアFuturismは、このCNETのAIで

ウェブ制作の現場で一般的に使われるようになってきたデザインツール「Figma」。そのFigma上で動作する文章校正支援プラグイン「テキスト校正くん」を弊社からリリースしました。無料で利用できます。 テキスト校正くん for Figma 本プラグインを利用することで、画面内の文章を手軽に校正でき、テキストの品質を高めることができます。 「テキスト校正くん」はテキストエディターの「VS Code」（参考）や、デザインツールの「Adobe XD」向けの拡張機能（参考）として以前から公開しており、多くの方に利用いただいています。とくにVS Code版の「テキスト校正くん」は約4万インストールも利用されており、今も利用者が増えています。「テキスト校正くん」の校正機能をさまざまなツールで利用できるよう、今回はFigma向けのプラグインとして新たに開発し公開しました。 「テキスト校正くん」でできること

文章の校正チェックを自動で行うVisual Studio Codeの拡張機能「テキスト校正くん」を弊社からリリースしました。無料で利用できます。 テキスト校正くん – Visual Studio Marketplace 短い文章であれば目視でもチェックできますが、長文になるとチェックに時間がかかり見落としも多くなってしまいます。また、いくら内容のいい文章を書いても誤字や脱字が多く体裁が整っていないと、印象が悪く読みづらい文章になってしまいます。 そんなとき、「テキスト校正くん」を利用することで、文章チェックの手間を軽減でき、文章の品質を高めることができます。 ▲VS Codeの拡張機能「テキスト校正くん」 「テキスト校正くん」でできること この拡張機能は、VS CodeでテキストファイルやMarkdownファイル等の日本語の文章をチェックします。編集時に自動で校正のチェックを行い、エディタ

こんにちは！ 開発部 テクニカルコミュニケーションチーム（以下、TCチーム）の原嶋です。 さてさて。 みなさん、ドキュメントの文章校正（以下、校正）ってどんな風にやっていますか？ 目視チェックでバッチリだぜ！という方も もちろんいると思うのですが、チェックポイントが多いと指摘が漏れてしまいがちですよね。そして、会社の公式文書となれば、チェックポイントはあれもこれもと山のようになります。 TCチームでも長年 校正に頭をかかえていましたが、textlint と＋αのツール を使って、校正の悩みを解決しました。 今回はその経緯をお話させてください。 校正って確認する項目がたくさん TCチームでは、サイボウズ製品のユーザーサポートコンテンツ（ヘルプやリリースノートなど）を作成しているのですが、 それらのコンテンツは会社の公式文書なので、毎回の校正でチェックする項目が多々あるんです。 校正おわったー

凸版印刷は1月8日、AI技術を活用して文章の誤りを指摘する「AI校閲・校正支援システム」を、みずほ銀行に提供したと発表した。みずほ銀は1月から同システムを活用し、パンフレット制作時の専門用語のレギュレーションチェックなどを行っている。 同システムは、広告、パンフレット、カタログなどの原稿を読み込ませると、誤変換や誤字脱字を自動で検出する。文脈を分析し、「保証」と「補償」といった熟語の使い分けもできるという。 業界・企業特有の言い回しや専門用語を学習させ、指摘の精度を高められる機能や、言葉遣いのレギュレーションを複数インプットし、著作物に応じて使い分けられる機能も備える。ユーザー企業の担当者は、分析結果を基に原稿を修正し、文章を読みやすく改善できる。 みずほ銀は凸版印刷の実証実験に協力し、2018年12月～19年3月にかけて同システムを広告制作などで活用していた。実験では、レギュレーションチ

『読みやすい技術書を書く技術』とは 『読みやすい技術書を書く技術』では、「書く」というプロセスにソフトウェア開発の考え方を導入します。 この本では読みやすい文章を執筆するための「環境構築技法」にフォーカスし、継続的に文章を校正する仕組みを整えます。 ちなみに「文章を読みやすくする文章術」については一切出てきません。 対象読者は「読みやすい文章を書きたいエンジニア」です。 技術書のような長い文章を書く人には、特に役立ちます。 また、技術ドキュメントやブログを書く人にも有益です。 techbookfest.org なにが書かれているか 「読みやすい技術書を書く技術」では校正ツールprh・RedPen・textlintの使い方を学びます。 さらにこれらのツールをCircleCIに組み込み、校正ツールを実行するCI環境を構築します。 最終的には次のようなワークフローの継続的インテグレーションを実現

「著者から後書きに名前を入れていいか聞かれることはありますが、誤植が後で見つかったらと思うと怖いですね」。引用部分を探す苦労、事実確認はどこまでするか…出版の分野で活躍する校正・校閲者の方々に聞きました。... 「これは会社の財産ですね。ぜひ公開してほしい」 「校閲者や司書は泣いて喜ぶと思いますよ」 毎日新聞の校閲センター内で共有しているインターネットサイトのリンク集のことです。私たちの仕事に合わせて作ってきたので一般にどこまで役に立つか分かりませんが、そのような声をいただいたため、どなたでもアクセスできる部分などを公開することにしました。 このリンク集の始まりは2009年ごろ。米国の雇用統計や消費者物価指数など、一から調べると手間がかかる経済関係の情報を早く調べるためでした。そこからスポーツなどデータが豊富に使われる記事などでもリンクがまとまってあれば便利だということで徐々に分野が広がり

この記事は、write-blog-every-week Advent Calendar 2018の6日目の記事です。 write-blog-every-weekSlackへのjoinはこちらから 概要 ブログ記事を書くときには、読みやすい文章を書くことに意識を割かなければなりません。 11月からカックさん( id:kakku22 )のブログメンターを受けていますが、 誤字、脱字について注意を受けることが何度かありました。 とくに技術系の用語について GitHubをgithubと書いてしまう(大文字小文字の誤字) QiitaをQittaと書いてしまう(スペルミス) というミスが多くありました。 これに気付くのはなかなか難しいため、校正ツールを導入しました。 ブログ執筆を支える技術としての紹介記事です。 テキスト校正くん VS Codeにテキスト校正のためのプラグインが存在します。 ics.m

文章の校正チェックを自動で行うVisual Studio Codeの拡張機能「テキスト校正くん」を弊社からリリースしました。無料で利用できます。 テキスト校正くん – Visual Studio Marketplace 短い文章であれば目視でもチェックできますが、長文になるとチェックに時間がかかり見落としも多くなってしまいます。また、いくら内容のいい文章を書いても誤字や脱字が多く体裁が整っていないと、印象が悪く読みづらい文章になってしまいます。 そんなとき、「テキスト校正くん」を利用することで、文章チェックの手間を軽減でき、文章の品質を高めることができます。 ▲VS Codeの拡張機能「テキスト校正くん」 「テキスト校正くん」でできること この拡張機能は、VS CodeでテキストファイルやMarkdownファイル等の日本語の文章をチェックします。編集時に自動で校正のチェックを行い、エディタ

表題の書籍を読んでみました。本業ではないとは言え、仕事をする上で何かと通訳や翻訳をすることがありますので、日本人ネイティブはどういったミスに陥りやすいのかに関する知識を深めたかったからです。本書は、46万稿の校正実績を持つ英文校正会社エディテージが執筆。ただし、本書を執筆するに当たり分析に処されたのは100本…このうち85本は英語の内容について、そして15本は体裁についてそれぞれ分析しています。また、前述の85本についても、前文では無く、各論文から無作為で1000ワード分の文章を抽出して分析をしています。多ければ良いというものではありませんし、何をもって充分とするのかもややこしいところですが、元データのボリュームとしてはちょっと少ないような気もします（会社規模からして特に）。また、本書の後半部分で論文の構成と体裁等々を暑く論じているのに、本書冒頭にある論文100本の分析結果の概要があっさり

こんにちは！ 新オフィスに移転してから毎日2缶ドクターペッパーを買うのが習慣化してきた @fortkle です。 今回はSlackで簡単に文字校正ができるBotを作ってみたのでご紹介したいと思います。 手軽に校正したい メールやチャットだけでなく、こういったブログやissueに書く仕様など「文章を書く」シーンはたくさんあると思います。 そんなとき自分が伝えたいことを相手にちゃんと伝えることができれば良いのですが、良い文章を書くのはなかなか難しく、今も試行錯誤しています。 そこで、相手に伝えたいことがちゃんと伝わる良い文章を書くためにSlack上で簡単に試せる文字校正Botを作ってみました。 成果物 実際に見たほうが早いと思うので画像を交えてご紹介します。 例として以下の文章をチェックしてみたいと思います。 この文章はご存知の通り、ダミーテキストです ヽ(^o^)丿 そして、様々な、ｴﾗｰﾁ

最近、RedPenという技術文書向け校正ツールを知りました。RedPenについては、RedPenを使って技術文書を手軽に校正しよう：連載｜gihyo.jp … 技術評論社に詳しい説明があります。 本格的に文章を書くようになり、こういったツールを求めていたため、早速試してみることにしたのですが、epubcheckをepub_validatorを使っている身としては、RedPenもRubyから使いたいなぁと思ったので、折角なので最近覚えたRubyを使ってepub_validatorのコードを参考にラッパーツールを作ってみることにしました。 RedPenRuby is a Ruby wrapper for redpen: a text inspection tool. akinomurasame/redpen_ruby redpen_ruby | RubyGems.org とりあえず、希望する動

はじめに 本連載ではRedPenという自動文書検査ツールの紹介とRedPenを利用した技術文書の校正方法について説明します。RedPenはオープンソースプロジェクトで、現在もゆっくりと開発が続いています。RedPenのホームページは次のとおりです。 http://redpen.cc RedPenは技術文書をターゲットにした文書の自動検査ツールです。技術文書にはマニュアルやチュートリアル、論文、仕様書等が含まれます。この記事のようなソフトウェアツールの紹介文書はもちろん技術文書の一つといえます。第1回の今回は、はじめに技術文書の特徴を解説し、その後RedPenを開発した動機について紹介します。記事の後半では、RedPenの特徴と利用方法について解説します。 技術文書の特徴 RedPenが対象とする技術文書ですが、作文や日記、文学作品等とは大きく異なる特徴をもちます。 最大の違いは、技術文書に

セルフパブリッシングの小説『天使の街』では、プロの校正者さん（校閲さん）に原稿のチェックを依頼しました。セルフ・パブリッシングでは、そこまでやる人はあまりいないと思いますが、作品としても商品としても完成度を高めたい、という想いから、意を決してお願いすることにしました。 今回は、校閲さんにどのような指摘をいただいたか、また事前にどんな準備したか、といったことをご紹介していきます。 ［2017年8月24日追記］見出しは「校正者」としていますが、厳密には「校閲者」が正しい表現です。 校閲さんは小説をどのようにチェックしているか？ 具体的にどんなふうにチェックが入るのか、いくつか例を挙げてみましょう。実際は単純な誤字脱字もご指摘いただいていますが、ここでは作品の書き手として「興味深い」ものを取り上げていきます（ちなみに、黄色い斜めの線は、原稿に反映させた、という自分の目印です）。 よく似た言葉　そ

2023年に蒔いた多肉・サボテンの幼苗の様子 2023年に蒔いた多肉・サボテンの幼苗の様子です。 フライレア・豹の子（Frailea pygmaea）です。 おしくらまんじゅうしております。 1つの鉢に蒔きすぎました。 3年前にも海外輸入物のフライレアの種子を蒔いた事がありまして、その時は1つも発芽しませんでした。 その…

joblint は、求人募集の文面に問題がないかを確認するためのプログラムです。 英語の人材募集の文面を書いた後でこのツールにかけると、以下のような「間違い」を検出し、指摘してくれます。 上のサンプルのように、検出された […] joblint は、求人募集の文面に問題がないかを確認するためのプログラムです。 英語の人材募集の文面を書いた後でこのツールにかけると、以下のような「間違い」を検出し、指摘してくれます。 上のサンプルのように、検出された様々な問題点は、4つのカテゴリー「文化的な問題」「現実性の問題」「採用者の問題」「技術的な問題」に分類され、点数づけられます。 チェック項目 joblintのソースを読んで、どんな内容がチェックされているのかを見てみました。引用は、その項目が検出された際にツールが表示するメッセージを訳したものです。 見せ掛けの利益 “beer(ビール)”, “ピザ