マニュアルよりチュートリアルがいい。

kintone Night Nagoya vol.40

Transcript

1. マニュアルより チュートリアルがいい。 2026.10.30 kNN vol.40 RUSHTECH / 伊藤明裕
2. ⾃⼰紹介 ‧20代 アセンブラでの開発や汎⽤機の運⽤。 ‧30代 システム開発プロセス、オブジェクト指向分析∕設計 ∕プログラミング。 ‧40代 マルチメディア、webサービス構築、システム管理、 情報セキュリティ。 ‧50代 DX（クラウド活⽤）、IoT、AI（機械∕深層学習）。 ‧60代 フィジカルAIなど。
3. 最近のkintone案件 JDLA［⽇本ディープラーニング協会］などが主催している、 DCON：DeepLearning コンテスト ＝ “⾼専⽣による事業創出コンテスト” https://dcon.ai/ の業務管理システムをkintoneで構築しています。
4. マニュアルって必要? • 最初にマニュアル読むか? • マニュアルに助けられたことある? • 「チャットボットに聞く」で解決したこ とある?
5. マニュアルって必要? • 最初にマニュアル読むか? • そんな⼈めったにいない。 • マニュアルに助けられたことある? • 無くは無いが、先にAIに聞くよね。 • 「チャットボットに聞く」で解決したこ とある? • ⽇本企業のAIチャットボットはなぜあんな に使いものにならないのだ?
6. よくあるポンコツ例。 例： 1. ファイルメニューの機能 1-1. “新規作成”：新規にファイルを作成します。 1-2. “開く”：既存のファイルを開きます。 だいたい、こういうのが多い。これが必要かつこれでいいと思ってるのは誰?
7. ⼿順書にやたらスクリーンショットがある。 業務システムのマニュアルはほとんどコレ。 • 最⼤の⽋点：考えさせないこと。 できない⼈ほど⾒た通りにクリックするだけで、動作の内容を理解しようと しない。 • すぐ使えなくなる：バージョンアップに追従しきれない。 ちょっとでも⾒た⽬が変わったりしたら、使い⽅がわからない⼈続出。
8. 別のおもしろ例。 「社内システムだし、マニュアルはどうせ読まないから作らない。 質問来ると⾯倒くさいから、画⾯に全部書いておく。」 その結果、作るように⾔われたボタンはこんな感じ。 もちろん、全体が<button>タグです。 このページを印刷するにはこのボタンを押してください。 出⼒されるプリンターはパソコンの設定に依存します。 👉ここをクリック!
9. マニュアルより先にチュートリアルが欲しい。 「このツールをこう使うと、こういうものができる。」という⼀連の流れがわか ると使い始めることができる。 最初にハードルを下げて「成功体験」を得られれば使う気になる。 使い慣れて来れば、⾃分で調べたり聞いたりしながらだんだん使い⽅を覚えるよ うになる。
10. 昔、初めて使った動画編集のソフト。 当時動画編集の知識はまるでなかったが、 カノープスのソフトだったか、付属の10分程度のチュートリアルビデオがとても よくできていて、 ⽤意されたサンプルファイルを読み込んで、よくある基本的な編集処理を⼀通り ⾏い、レンダリングして編集後の動画ファイルを書き出すまでの⼀連の流れを追 えた。 そのおかげで、すぐに実務で動画編集できるようになった。 これ以来、「マニュアルよりチュートリアルを作れ派」。
11. 今年の春、Antigravity2.0 が出た。 起動したらこの画⾯。 IDEなのにソースコード⾒れ ない? でも、コンセプトがわかっ たら説明不要ですぐ使える ようになった。開発にはほ ぼこれしか使ってない。 いいツールはマニュアルい らない⼀例。
12. kintoneの場合。 • DCONでの事例では、⾼専⽣から今まで「kintone⾃体の使い⽅」についての 質問は⼀度もなし。 • その他、関係各社の⽅からも、kintone⾃体使えない∕わからないという話 は聞かない。 • 多分に⽇本的な作りが功を奏していると思われる。 （サイボウズUI/UXチームの狙い通り?） • アプリ連携、プロセス管理などの操作にはさすがにちょっと説明が必要だ が、簡単な説明で済んでいる。
13. 最後に。 ▪ 今までの登壇資料： https://speakerdeck.com/akit37 とはいえ、［当⽇限定］。 道具を誰もがすぐにうまく使えるわけではないので、UI設計はとても⼤事。 いまどきは、使い⽅に困ったらAIに聞けばいい。 → AIの学習⽤として、詳しいマニュアルは必要。（PDFより、Markdown推 奨。） もう⼀点、エンジニア向けに。 エラーメッセージを出す時に、ダメ出しだけするアプリケーションが多すぎる。 ダメな理由と、”次にどうしたらいいか”をユーザに教えてあげること。