2044156

情報開発と利活用

令和維新

2004年4月から企業を離れ、コンサルタントや情報起業を試行しながら、失われた２０年を取り戻し、日本再生をめざす私の歩みをみて一人でも多くの後継者が出てくれることを祈りつつ友達から紹介されたこのホームページの更新を続け、これまでの活動の記録と今やビッグデータ、AI,、IOT,ブロックチェーン、仮想通貨の時代になってしまいましたが、私の現状認識と関連技術を紹介していきたい。

フォローする

UX

(0)

オンライン

(0)

ソーシャルメデイア

(0)

開発

(0)

スマートマネー

(0)

流動性

(0)

教育訓練開発手法の紹介

Headline News

Shopping List

お買いものレビューがまだ書かれていません。

< 新しい記事

新着記事一覧(全8348件)

過去の記事 >

2026.07.25

(1)テクニカルドキュメンテーションのためのコンテンツデザイン実践の構築(Building a Content Design Practice for Technical Documentation)

テーマ： Webのコンテンツ作成(8)

カテゴリ：ドキュメンテーション

Building a Content Design Practice for Technical Documentation

テクニカルドキュメンテーションのためのコンテンツデザイン実践の構築

Michelle Bacigalupi, Guidewire Software
ミシェル・バチガルピ、ガイドワイヤー・ソフトウェア

October 15, 2025
2025年10月15日

Introduction
はじめに

This article traces the evolution of the Guidewire documentation site from a traditional site for technical documentation to an ecosystem of information experiences. We’ll delve into the pivotal moments, challenges, and successes that have shaped this journey, culminating in the establishment of a dedicated Content Experience Design (CXD) team and a vision for the future.
本記事は、Guidewireのドキュメンテーションサイトが、従来のテクニカルドキュメンテーション向けサイトから情報体験のエコシステムへと進化を遂げた軌跡をたどるものである。この旅路を形作ってきた決定的な瞬間、課題、そして成功について深く掘り下げ、専用のコンテンツ体験デザイン（CXD）チームの設立と将来へのビジョンにおいて結実したプロセスを解説する。

Focus of this article:
本記事のポイント：

出発点：従来のドキュメンテーションから動的な情報体験へと変貌を遂げた、Guidewireのテクニカルドキュメンテーションサイトにおける成功した進化の簡単な歴史。
 Starting small: The initial introduction of visual and interactive design elements, outlining early successes and challenges.
スモールスタート：視覚的および対話型のデザイン要素の初期導入と、初期の成功および課題の概略。
 Building a small CXD team: The strategic hiring of a visual designer and the cultivation of a collaborative environment with colleagues.
小規模なCXDチームの構築：視覚（ビジュアル）デザイナーの戦略的な採用と、同僚との協調的な環境の育成。
 Accomplishments: A detailed look at key successes and areas identified for improvement.
成果：主な成功体験と改善点として特定された領域の詳細な考察。
 Vision for what is next: Our forward-looking strategy, including the integration of artificial intelligence and continued cross-team synergy.
次のステップに向けたビジョン：人工知能（AI）の統合や継続的なチーム間シナジーを含む、私たちの未来志向の戦略。
 Lessons learned: Key takeaways and best practices derived from our journey.
得られた教訓：私たちの旅路から導き出された主要な学びと最善事例。

Our starting point
私たちの出発点

テキストやマルチメディアを含む素晴らしい情報体験を創出し、学習を促進することで、エンドユーザーが自身の「片付けるべき仕事（JTBD）」*を迅速かつ正確に完了できるようにする方法

Our journey has been nothing short of extraordinary. Three years ago, we embarked on a transformative path, driven by a core principle: “How might we create awesome information experiences, which include text and multimedia, to accelerate learning and enable our end users to complete their Jobs-to-be-Done (JTBD)* quickly and accurately?” This guiding statement fueled our efforts across both the Information Experience (IX) and Learning Experience (LX) teams.
私たちの旅路は正に特別なものであった。3年前、私たちは「テキストやマルチメディアを含む素晴らしい情報体験を創出し、学習を促進することで、エンドユーザーが自身の『片付けるべき仕事（JTBD）』*を迅速かつ正確に完了できるようにするにはどうすればよいか？」という中核となる原則に突き動かされ、変革の道へと乗り出した。この指針となる言葉が、情報体験（IX）チームおよび学習体験（LX）チーム双方の取り組みを加速させたのである。

*Definition of JTBD: Jobs-to-be-Done (JTBD) is a framework that focuses on the underlying goal or problem an end user is trying to solve, rather than just the product features.
*JTBDの定義：片付けるべき仕事（JTBD）とは、単なる製品の機能ではなく、エンドユーザーが解決しようとしている根本的な目標や問題に焦点を当てるフレームワークである。

First steps
最初のステップ

私たちは、急速に勢いを得ることとなったいくつかの重点プロジェクトを小規模に始めるという、焦点を絞った反復的なアプローチから着手した。最初の取り組みの一つは、ドキュメンテーションサイトのヒーローセクション（最上部のメインビジュアル領域）の再設計であった。その目的は、すべてのドキュメンテーションのランディングページにわたって一貫したデザインとコンテンツ構造を確立することであった。ヒーロー要素は、特にGuidewireの製品ドキュメンテーションにおいて、ブランド認知のために不可欠である。美観にとどまらず、この目立つ視覚領域における一貫性は、認知負荷を軽減し混乱を防ぐことで、ユーザー体験を大幅に向上させる。ユーザーは自分が正しい場所にいることを即座に認識でき、親しみやすさと信頼感を育むことができる。

Landing page hero which shows across all landing pages
すべてのランディングページに表示されるランディングページのヒーロー

Another significant effort was the development of consistent product area landing pages. Informed by extensive user research, these pages were designed to help end users build a strong mental model, simplifying search and navigation. We implemented a hub-and-spoke model, where central landing pages guide users to more detailed articles, enabling them to learn a predictable information hierarchy and visual language. This consistency not only builds user trust by aligning content with visuals but also allows users to focus on the information itself rather than expending effort to understand the structure of each new page.
もう一つの重要な取り組みは、一貫した製品エリアランディングページの開発であった。広範なユーザー調査に基づき、これらのページはエンドユーザーが強固なメンタルモデルを構築し、検索やナビゲーションを単純化できるように設計された。私たちはハブ・アンド・スポーク・モデルを導入した。ここでは、中心となるランディングページがユーザーをより詳細な記事へと誘導し、予測可能な情報階層と視覚言語を学習できるようにしている。この一貫性は、コンテンツとビジュアルを一致させることでユーザーの信頼を築くだけでなく、新しいページごとの構造を理解するために労力を費やすのではなく、情報そのものに集中することを可能にする。

Componentized landing pageコンポーネント化されたランディングページ

Feedback from our end-user research underscored the need for these improvements. Users highlighted that:
エンドユーザー調査からのフィードバックは、これらの改善の必要性を強調していた。ユーザーからは以下のような点が指摘された：

 “…the site could be improved by organizing information more intuitively, making content clearer and more comprehensive…”
「…情報をより直感的に整理し、コンテンツをより明確かつ包括的にすることで、サイトを改善できる可能性がある…」
 “To enhance user experience, …improve the site’s organization and accessibility…by categorizing information based on jobs-to-be-done…”
「ユーザー体験を向上させるために、…片付けるべき仕事に基づいて情報を分類することで、サイトの組織化とアクセシビリティを改善する…」

To evaluate the effectiveness of this new approach, we conducted several surveys across multiple product area landing pages. Our objective was to validate that these redesigned pages enhance the end user’s experience. The results /> our approach, as the new product area landing pages consistently averaged high scores.

この新しいアプローチの有効性を評価するため、私たちは複数の製品エリアランディングページにわたっていくつかのアンケートを実施した。私たちの目的は、これらの再設計されたページがエンドユーザーの体験を向上させていることを検証することであった。新しい製品エリアランディングページが総じて高い平均スコアを獲得したため、結果は私たちの方向性を裏付けるものとなった。

Survey data:
アンケートデータ

The primary poll question asked users to rate their agreement with the following statement using a 5-point Likert scale (from “strongly disagree” to “strongly agree”):
主な投票質問では、 5 段階のリカート尺度（「全く同意しない」から「強く同意する」まで）を使用して、次のステートメントに対する同意度を評価するようユーザーに求めた：

“The layout on this page makes it easy to find the information I need.”
「このページのレイアウトのおかげで、必要な情報を容易に見つけることができる。」

Results of usability research of landing pages
ランディングページのユーザビリティ調査結果

These results strongly supported our hypothesis that creating consistency across all efforts— particularly by organizing content around JTBD, the core tasks and problems our users need to solve—significantly improved usability.
これらの結果は、すべての取り組みにおいて一貫性を創出すること、特にユーザーが解決する必要のある中核的なタスクや問題である「 JTBD 」を中心にコンテンツを整理することが、ユーザビリティを大幅に向上させるという私たちの仮説を強力に支持するものであった。

インターネット・コンピュータランキング
==============================
ネットサービスランキング
==============================