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

マニュアルよりチュートリアルがいい。 2026.10.30 kNN vol.40 RUSHTECH / 伊藤明裕

⾃⼰紹介 ‧20代アセンブラでの開発や汎⽤機の運⽤。 ‧30代システム開発プロセス、オブジェクト指向分析∕設計 ∕プログラミング。 ‧40代マルチメディア、webサービス構築、システム管理、情報セキュリティ。 ‧50代
DX（クラウド活⽤）、IoT、AI（機械∕深層学習）。 ‧60代フィジカルAIなど。

最近のkintone案件 JDLA［⽇本ディープラーニング協会］などが主催している、 DCON：DeepLearning コンテスト＝ “⾼専⽣による事業創出コンテスト” https://dcon.ai/ の業務管理システムをkintoneで構築しています。

マニュアルって必要? • 最初にマニュアル読むか? • マニュアルに助けられたことある? • 「チャットボットに聞く」で解決したことある?

マニュアルって必要? • 最初にマニュアル読むか? • そんな⼈めったにいない。 • マニュアルに助けられたことある? • 無くは無いが、先にAIに聞くよね。 •
「チャットボットに聞く」で解決したことある? • ⽇本企業のAIチャットボットはなぜあんなに使いものにならないのだ?

よくあるポンコツ例。例： 1. ファイルメニューの機能 1-1. “新規作成”：新規にファイルを作成します。 1-2. “開く”：既存のファイルを開きます。だいたい、こういうのが多い。これが必要かつこれでいいと思ってるのは誰?

⼿順書にやたらスクリーンショットがある。業務システムのマニュアルはほとんどコレ。 • 最⼤の⽋点：考えさせないこと。できない⼈ほど⾒た通りにクリックするだけで、動作の内容を理解しようとしない。 • すぐ使えなくなる：バージョンアップに追従しきれない。ちょっとでも⾒た⽬が変わったりしたら、使い⽅がわからない⼈続出。

別のおもしろ例。「社内システムだし、マニュアルはどうせ読まないから作らない。質問来ると⾯倒くさいから、画⾯に全部書いておく。」その結果、作るように⾔われたボタンはこんな感じ。もちろん、全体が<button>タグです。このページを印刷するにはこのボタンを押してください。出⼒されるプリンターはパソコンの設定に依存します。 👉ここをクリック!

マニュアルより先にチュートリアルが欲しい。「このツールをこう使うと、こういうものができる。」という⼀連の流れがわかると使い始めることができる。最初にハードルを下げて「成功体験」を得られれば使う気になる。使い慣れて来れば、⾃分で調べたり聞いたりしながらだんだん使い⽅を覚えるようになる。

昔、初めて使った動画編集のソフト。当時動画編集の知識はまるでなかったが、カノープスのソフトだったか、付属の10分程度のチュートリアルビデオがとてもよくできていて、⽤意されたサンプルファイルを読み込んで、よくある基本的な編集処理を⼀通り⾏い、レンダリングして編集後の動画ファイルを書き出すまでの⼀連の流れを追えた。そのおかげで、すぐに実務で動画編集できるようになった。これ以来、「マニュアルよりチュートリアルを作れ派」。

今年の春、Antigravity2.0 が出た。起動したらこの画⾯。 IDEなのにソースコード⾒れない? でも、コンセプトがわかったら説明不要ですぐ使えるようになった。開発にはほぼこれしか使ってない。いいツールはマニュアルい
らない⼀例。

kintoneの場合。 • DCONでの事例では、⾼専⽣から今まで「kintone⾃体の使い⽅」についての質問は⼀度もなし。 • その他、関係各社の⽅からも、kintone⾃体使えない∕わからないという話は聞かない。 • 多分に⽇本的な作りが功を奏していると思われる。（サイボウズUI/UXチームの狙い通り?）
• アプリ連携、プロセス管理などの操作にはさすがにちょっと説明が必要だが、簡単な説明で済んでいる。

最後に。 ▪ 今までの登壇資料： https://speakerdeck.com/akit37 とはいえ、［当⽇限定］。道具を誰もがすぐにうまく使えるわけではないので、UI設計はとても⼤事。いまどきは、使い⽅に困ったらAIに聞けばいい。 → AIの学習⽤として、詳しいマニュアルは必要。（PDFより、Markdown推奨。）
もう⼀点、エンジニア向けに。エラーメッセージを出す時に、ダメ出しだけするアプリケーションが多すぎる。ダメな理由と、”次にどうしたらいいか”をユーザに教えてあげること。

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

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

ITO Akihiro

More Decks by ITO Akihiro

Other Decks in Technology

Featured

Transcript