Cybozu Meetup #19 ヘルプサイトについて語る会に参加してきました

2019/6/18に開催されたCybozu Meetupのヘルプサイトについて語る会に参加してきました。業務でサポートサイトのアップデートを担当しているのですが、基本的なヘルプサイトを作成する際の考え方から、データ分析、多言語対応サイトで効率的にコンテンツを管理する方法まで、短時間ながら非常に濃い内容でした。

内容

トークセッションは3つ。資料は以下のとおりです。

ヘルプサイトの制作プロセス

サイボウズ株式会社　仲田 尚央氏
サイボウズのヘルプサイトの作成ノウハウに関する基本的なお話でした。「いいヘルプ」を作成するためのプロセスを整理した上で、「誰が」「何を」「どのように」の観点から、ヘルプサイトの構成について整理する内容でした。




書籍も出されているとのことで参考になりそうです。

ヘルプサイトのデータ分析

サイボウズ株式会社　山本 絵理氏
定量的、定性的分析に基づいてヘルプサイトの具体的な改善例についてのお話でした。Google Analyticsによるデータ収集、Googleデータポータルによる可視化、分析レポートの共有、アンケートなどの定性データと組み合わせたより効果の高い改善活動の紹介がありました。


ヘルプサイトのデータ分析 from Eri Yamamoto



GitHubと翻訳支援ツールで多言語サイトの更新を超速にする

サイボウズ株式会社　澤井 真佑子氏
多言語展開しているヘルプサイトの更新作業の効率化に関するお話でした。GitHub上でコンテンツ管理し、MemsourceというCATツールと組み合わせて、netlify上でHugoを使ってコンテンツを公開するというもの。




感想

さすがのサイボウズさん

長年プロダクトを提供されているだけあって、ヘルプサイトに対する手のかけ方が半端ないですね。正直、ここまでキッチリ改善や効率化をやれる環境は羨ましいです。一般的にはヘルプサイトを作るのが精一杯で、改善まで手が回らず結局放置というパターンが多い気がします。まずは収集したデータを可視化して、メンバーに共有するところが第一歩と感じました。蓄積したデータが見えれば、改善の指針として次の段階に進めるのではないでしょうか。その一歩がなかなか大変なところではありますが。

CATツールを使ってみたい

個人的には英文の技術ドキュメントを日本語訳する機会が多いのですが、お恥ずかしながらCATツールという括りのツールがあるのを初めて知りました。CATツール側で差分管理や用語の一貫性を保つのに便利な機能があるとのことで、うまく使えばかなりの効率化が図れそうな気がしました。

パックマンルールがいい

トークセッションの後は、立食形式で交流会に移ったのですが、面白かったのが「パックマンルール」。話をするときには新しい人が会話に入ってこれるように、一人分のスペースを空けて話しましょう、というもの。初体験だったのですが、自分が誰かと話をしているときにも、第三者を輪に招きやすくなるのと同時に、自分が他の輪に入りやすくなると感じました。この手のミートアップに行くとたいていボッチになるのですが、こういうルールがあるだけですごく改善される気がします。

笑むすび

イベント内で軽食を提供された「笑むすび」という会津米を使ったおむすび屋さんが良かったです。1口サイズのおむすびが話をしながら、聞きながら食べやすく、漬け物が特に美味しい。ビールに合います。うちのイベントでも使ってくれないかな。





コメント

コメントを投稿

このブログの人気の投稿

Execノードを使う

イメージ
ここのところずっと Node-RED のサンプルを見ながら各ノードの使い方を確認しています。 頭出しの記事はこちら をご確認ください。今回はExecノードです。Execノードを使うと外部のコマンドを実行することができます。コマンドが出力した、標準出力や標準エラー出力などをノードから出力できます。 標準出力の内容を出力する 最初に確認するサンプルは「 flows > node-red > function > exec > 01 - Get standard output from external command 」です。 Execノードのプロパティを見ると以下の通りになっています。 実行コマンドは「 echo 」 msg.payload で受け取った値を引数として利用 出力モードは「 コマンド終了時 - execモード 」 コマンド終了時に結果を出力します Execノードには出力ポートが3つあります。 標準出力 標準エラー出力 返却コード 実行すると、標準出力には「 Hello World! 」、返却コードには「 {code : 0} 」が出力されます。この挙動は特に説明することはないかと思います。 標準エラー出力の内容を出力する 次に確認するサンプルは「 flows > node-red > function > exec > 02 - Get error output from external command 」です。外部コマンドのエラーをポートに出力します。中身は先程のサンプルフローとほぼ同じですが、Execノードで存在しないコマンドを実行しています。 実行すると、以下のログが出力されます。これも説明不要かと思います。 実行中に出力する 最後に確認するサンプルは「 flows > node-red > function > exec > 03 - Run external command in spawn mode 」です。出力がコマンド実行中に行われるのがこれまでのサンプルと違う点です。 コマンドはwhieループ内で2秒おきに「 Hello 」を標準出力に出力し続けます。Spawnモードで実行するとループ内でechoコマンドが実行されるたびにログが出力されます。サービスっぽい...
続きを読む

SendGridのX-SMTPAPIヘッダの使い方（Section Tags、Substitution Tags編）

イメージ
前回に引き続き SendGrid についてです。 今回は SMTP API を使ってみました。 SMTP APIについて SendGridのSMTP APIは基本的には普通のSMTPプロトコルに則ったものですが、X-SMTPAPIヘッダというカスタムヘッダを使うことで機能を拡張することができます。 X-SMTPAPIヘッダについて X-SMTPAPIヘッダはSMTPプロトコルの拡張ヘッダです。 X-SMTPAPI: { "category": "newuser" } みたいな感じでJSON形式でパラメータを与えることで機能を拡張します。 Section TagsとSubstitution Tagsについて 今回はSMTP APIで使える機能のうちSection TagsとSubstitution Tagsを使ってみました。 Section TagsとSubsitution Tagsは送信メールの内容を宛先毎に特定の文字列を置換するための機能です。toと合わせて使うことで機能します。 例えば、X-SMTPAPIヘッダの値を以下のような形にします。 { "to": ["test1@xxx.xxx", "test2@yyy.yyy"], "sub": { "-body-": [ "-bodyFemale-", "-bodyMale-" ], "-favorite-": [ "バナナ", "カツオ" ], " "-nickname-": [ "ミキ", "サブロー" ] }, "section": { " "-bodyFemale-": "-nickname-さん！女性向けの商品のご紹介です。", "-bodyMale": "-nickn...
続きを読む

Joinノードを使う（その4）

イメージ
ここのところずっと Node-RED のサンプルを見ながら各ノードの使い方を確認しています。 頭出しの記事はこちら をご確認ください。今回はJoinノードの4回目です。終わらねぇ。 確認するサンプルは、 前回 に引き続き「 読み込み > サンプル > flows > node-red > sequence > join > 02 - Manual join mode 」です。 メッセージを結合してkey/valueオブジェクトにする 5段目のフローから見ていきます。ざっくりとした流れは以下のとおりです。 DataノードでCSVデータを送信する CsvノードでCSVデータをJSONオブジェクトに変換する msg.payloadには以下のような値が指定されたメッセージ4つに分解される { name: "Apple", price: 100 } Changeノードでmsg.payload内の値を以下のプロパティに設定する msg.topic = "Apple"（msg.payload.nameの値） msg.payload = 100（msg.payload.priceの値） Joinノードで、2個の受信メッセージごとにmsg.topicの値をキーとしてkey/valueオブジェクトに結合して送信する これを実行すると、以下のようにmsg.payloadにJSONオブジェクトが指定されていることを確認できます。 メッセージを結合して結合オブジェクトにする 先ほどは結合した値がkey/valueオブジェクトでしたが、6段目のフローでは単純にオブジェクト結合します。ざっくりとした流れは以下のとおりです。 DataノードでJSON配列を送信する nameをキーに持つオブジェクトとpriceをキーに持つオブジェクトを交互に含んでいます（実際、こんなに都合の良いデータが生成されることはあるんだろうか） Splitノードで配列データを個別のメッセージに分割します Joinノードで、2個の受信メッセージごとにオブジェクトに結合して送信する これを実行すると、以下のようにmsg.payloadに2個ずつのオブジェクトがJSONオブジェクトに結合されたものが指定されていることを確認できます。ちなみに、Joinノード...
続きを読む