Blog

ヘッドレスコンテンツ管理は、技術コンテンツを制作する出版社を含む、あらゆる種類の出版社にとって優れたオプションです。多くのテクニカルライターは、ヘッドレスの利点について知識がありません。この投稿では、ヘッドレスが11の主要分野で従来の技術コンテンツの慣行にどのように対抗するかを見ていきます。

ここ数十年の間、一部の組織はDITA （Darwin Information Typing Architecture）と呼ばれるアプローチを使用して技術文書を開発してきました。「Darwin」という名前が示すように、このアプローチは将来のコンテンツ要件に対応するために進化するはずでした。しかし実際には、DITAは、満足のいく配信ができない機能を約束するコンテンツを管理するための時代遅れのアプローチになっています。 DITA満足度調査によると、「DITAを使用している回答者の62％は、程度の差はあれ、不満を持っています。」 DITAを使用する組織の数は増え続けており、代替案を模索しており、DITAを試すことを決定した組織はしばしばすぐにその決定を後悔しています。

DITAの支持者は、構造化コンテンツを管理する唯一の方法を提供していると述べたり暗示したりすることがよくあります。DITAに代わる人気が高まっているヘッドレスコンテンツ管理があることを認めることはめったにありません。場合によっては、これらのライターはまだヘッドレスに精通していないため、それがオプションであることを知りません。 DITAとヘッドレスはどちらもコンテンツを構造化し、コンテンツの一貫性、再利用、カスタマイズをサポートしますが、類似点はそこで終わります。ヘッドレスはコンテンツ管理への最新のアプローチです。DITAは時代遅れのものです。

1.DITAは単一目的のアプローチです。ヘッドレスは多目的アプローチです

DITAは、技術文書用に設計されました。標準を微調整してその魅力を広げるための適切な努力にもかかわらず、DITAは、技術文書に関連する特定の規則に固定されたままです。 DITAは、マーケティングコンテンツ、一般的な関心のあるインタラクティブなWebサイト、または人気のあるスマートフォンアプリを管理するためのアプローチとして、広く成功を収めていません。 DITAは、特定の目的のための「専門化」に関するものです：技術ドキュメント。この狭い焦点の外でのDITAの主流化は長年議論されてきましたが、DITAのコアアーキテクチャが企業全体のソリューションとして実行可能ではないため、実際には発生していません。 DITAコンテンツは、企業の他のコンテンツとは別に存在する傾向があります。

ヘッドレスはあらゆる種類のコンテンツに適しています。ヘッドレスは技術文書に広く使用されていますが、さらに多くのことができます。eコマースサイトから主要なグローバル新聞まで、あらゆる種類のWebサイトに電力を供給します。スマートフォンアプリに最適なアプローチです。世界で人気のあるオンラインゲームの多くを推進します。そして、これは拡張現実やモノのインターネット（IoT）などの新しいアプリケーションにとって頼りになるコンテンツアプローチです。ヘッドレスアプローチの多様性により、企業はすべてのコンテンツを管理するために使用できます。

2.DITAは真にユーザー中心ではありません。ヘッドレスはオーディエンス中心です

DITAは、情報を構造化するための古いパラダイムに基づいており、教科書のような構造を再作成し、情報をタスク、概念、参照の3つの基本タイプに分割します（用語集の入力とトラブルシューティングもオプションです）。これらのドキュメント中心のアイデアは、一般的なアイデアを反映しています。人々が厚いユーザーマニュアルを読みながら情報を学び、ナビゲートする必要がある方法についての1990年代（DITAが考案されたとき）の見解。読者は情報の構造に準拠することが期待されています。DITAは、新世紀のユーザーリサーチが爆発的に増加し、UXのベストプラクティスが開発される前に正式に制定されました。

DITAの教訓的なアプローチとは対照的に、ヘッドレスは読者のニーズに焦点を合わせた外向きのスタンスを採用しています。ヘッドレスはAPIを介して特定の対象を絞った情報を提供することを前提としているため、オーディエンスのニーズが情報の構造を決定します。視聴者のフィードバックに基づいて変更されます。

3.DITAコンテンツは移植性がありません。ヘッドレスコンテンツは

よくある誤解は、DITAは標準であるため、DITAコンテンツは移植可能であるというものですが、DITAに準拠しているからといって、コンテンツが別の発行元のコンテンツと相互運用できるわけではありません。DITAは、DITAコンテンツをあるツールからに移行できるベンダー標準です。別の。コンテンツ構造自体の記述が閉じられているため、標準が必要です。その構造は「ツリー」に包まれています。つまり、DITAコンテンツ内の要素は外部の関係者に知られていないか、アクセスできません。ツリー内のコンテンツ要素のフィルタリングを制御する発行者はゲートキーパーです。この構造化方法それぞれが異なる方法でコンテンツを説明するため、異なるソースからのコンテンツをマージすることは困難または不可能ですらあります。

ヘッドレスでは、コンテンツはオープン（APIアクセス可能）であるため、ベンダーが合意した標準は必要ありません。組織は、ヘッドレスシステム間でコンテンツを問題なく日常的に移動します。ヘッドレスは、さまざまなソースのコンテンツをマージおよび結合できるように設計されています。これにより、組織はコンテンツのライブラリを外部の関係者と共有したり、選択したコンテンツのフラグメントのみを共有したりできます。組織は、必要なものを簡単に共有でき、他の場所からコンテンツを問題なく取り込むことができます。

4.DITAはそのセマンティクスで明示的ではありません。ヘッドレスは

DITAは、別の誤解を招く特性である「セマンティック」であると主張することがよくあります。その複雑さにもかかわらず、DITAフレームワークは一般的すぎて、さまざまなソースからのコンテンツを調整できません。各パブリッシャーがDITAフレームワークの実装を決定する方法には常に特異な違いがあるため、2つの異なるソースは、モデルの意味に同意しません。DITAでは、意味は、互いの内部の要素のネストによって影響を受けます。要素の意味Webサイトのサイトマップとは異なり、DITAツリー上の位置によって異なります。コンテンツ構造の意味は、各組織の特定の実装に固定されています。

ヘッドレスのコンテンツの構造は、深いネストではなくリレーショナルリンクに重点を置いて、より大きな自律性を促進します。ヘッドレスの場合、要素の意味は、より大きなコンテンツモデル内の場所に依存しません。他の関係者は、モデル全体を理解する必要はありません。要素にアクセスできます。各要素には、ツリー内での位置を気にせずに直接アクセスできる一意のAPIアドレスがあります。

5.DITAコンテンツは真のオムニチャネルではありません。ヘッドレスコンテンツは

DITAは、オムニチャネルではなくマルチフォーマットです。 Web、印刷、PDF、CD-ROMなどのさまざまな形式でドキュメントを作成できます。DITAはテンプレートに依存して特定の宛先のコンテンツをフォーマットしますが、さまざまな形式を作成するだけではオムニチャネルエクスペリエンスはサポートされません。ユーザーはt同じコンテンツの異なるバージョンが必要なだけです。 DITAでは管理できない、ユーザーのコンテキストに適応できるように、コンテンツ要素、チャネル、およびエクスペリエンスをリアルタイムでシームレスに統合する必要があります。

ヘッドレスは設計上チャネルに依存しません。ヘッドレスシステムには、テンプレートに起因する制限がありません。事前定義された出力の設定範囲に制限されません。コンテンツをアセンブルして表示できる多数のライブラリに接続できます。無制限の方法。つまり、任意のチャネルまたはプラットフォームに簡単に配信できます。さらに、コンテンツを簡単に再利用できるように、ライブラリを簡単に切り替えることができます。ヘッドレスは、チャネルを切り替えるとき、およびそうするときに異なるエクスペリエンスとコンテンツを期待するときに、顧客をサポートします。

6.DITAは時間内に凍結されます。ヘッドレスは急速に進化しています

DITAの基本構造は、2000年代初頭にIBMによって設定されました。それ以来、DITAにはいくつかのマイナーな改訂がありましたが、コア標準はあまり変更されておらず、変更される可能性は低いようです。 DITAは、大企業の参加が限られている、ほとんどが小規模のコンサルタントとベンダーの自主的な委員会によって管理されています。最近の活動は、DITAを簡素化してその魅力を広げる方法に焦点を当てています。これは、標準が扱いにくく人気がなくなっているという認識です。重要なことに、委員会の参加者の関心が低かったため、人気を拡大した可能性のあるDITAを改革する1つの提案（JSON互換性の追加）が取り下げられました。JSON互換性（最新のコンテンツ交換の基本基盤）がなければ、DITAは狭いニッチに孤立しています。 。

対照的に、ヘッドレスは構造化コンテンツを管理するアプローチとして急速に進化しています。企業は数十のヘッドレスベンダーから選択でき、業界の成長は爆発的です。ヘッドレスは、Global 500企業の大部分を含む、あらゆる規模の企業やあらゆる業界で採用されています。ヘッドレスコンテンツの管理に利用できる機能も拡大を続けており、新しいAPI機能とさまざまなマイクロサービスを利用できるようになっています。他のシステムやデータソースとの統合。

7.DITAの変更は面倒です。ヘッドレスの変更は簡単です

必要に応じて構造を簡単に変更できない場合、コンテンツを構造化することはほとんど価値がありません。変更する機能に関しては、DITAは壊れやすく、ヘッドレスはアジャイルです。

DITAは、コンテンツの構造化とコンテンツロジック（「文法」、「プロファイリング」などと呼ばれます）を1つのパッケージにまとめます。コンテンツのすべての要素は、華やかなXMLツリーのブランチであり、場合によっては多くのレベルの深さです。最初に作成したときは複雑であり、後でブランチを追加または削除する必要がある場合は、管理がさらに大きな課題になる可能性があります。 DITAは、一度配置すると変更するのが困難です。また、ツリーを横断して特定のアイテムを見つけるために使用されるXML文法は、予期しない事態が発生したときに正常に失敗することはありません。ライターは、欠落している参照のデバッグや検証エラーのトラブルシューティングなどの陽気なタスクに直面します。

ヘッドレスはこの混合を回避します。コンテンツの構造を、他のアプリケーションやシステムがコンテンツのクエリとアセンブルに使用するコードから分離します。これにより、ネストされた内部ロジックに依存しないため、コンテンツの構造を簡単に変更できます。ヘッドレスのアーキテクチャシステムは、コンテンツ構造が必要に応じて特定の機能を追加または削除できるように設計されています。

8.DITAの習得と使用は困難です。ヘッドレスは簡単です

DITAは、習得が難しく、広範なトレーニングが必要なことで有名です。DITAの専門知識は、その内部ロジックとコーディング規則を理解するために何年もの練習を必要とする場合があります。学習の大きな障壁の1つは、コンテンツ構造がコンテンツ内にネストされたマークアップに依存していることです。ここでは、単純な文でもコーディング資格を埋め込むことができます。ネストされたXMLマークアップの複雑さに対処したいライターはほとんどおらず、多くの従業員は、 DITAを採用し、その急な学習曲線に遭遇することを余儀なくされました。洗練されたUIの背後にあるDITAのマークアップを偽装しても、その概念的なハードルと実装の課題が解消されるわけではありません。 DITAが機能するためには、作成者はある程度コードに関与する必要があり、場合によってはXML開発者になる必要があります。執筆とコード開発の両方に対応できる従業員は費用がかかり、見つけるのが困難です。これが、DITAが企業全体に拡大しない主な理由です。DITAを操作するために必要な専門スキルを持っている人はほとんどいません。

Kentico Kontentなどの優れたエンタープライズ指向のヘッドレスCMSは、技術者以外のユーザーを念頭に置いて設計されたシンプルなオーサリングインターフェイスを備えており、コンテンツをパーツに分割して、作成者が書き込み、編集、コメントする必要のある部分に簡単に集中できるようにします。優れたオーサリングシステムでは、ライターがテキストに気を散らすような不可解なマークアップを使用することはありません。ヘッドレスCMSは、オーサリングエクスペリエンスがかなり異なることに注意してください。ほとんどすべてのヘッドレスシステムは、DITAよりも作成者にとって使いやすいですが、すべてのヘッドレスシステム、特にGitベースのシステム（クラウドではなく）が優れたユーザーエクスペリエンスを提供するわけではありません。 -ベース）、Markdownに依存しているため、オーサリングエクスペリエンスを慎重に評価してください。

9.DITAコンテンツの配信が遅い。ヘッドレスコンテンツ配信は高速です

DITAは、静的コンテンツを配信するように設計されたWeb1.0テクノロジーです。テンプレートに依存して、小さな変更が加えられるたびにコンテンツの本体全体をフォーマットします。DITAコンテンツがコンパイルされます。すべてのマテリアルを同時にアセンブルする必要があります。必要な要素は、はるかに大きなツリーであるため、ツリーをフィルタリングして目的の要素をまとめるのに必要な時間は、最新の標準に基づいています。

ヘッドレスは、Web 3.0以降のコンテンツアーキテクチャです。あらゆる種類のコンテンツの分散および自動化された検出、取得、および変換の準備ができています。必要なときに必要なものを正確に提供できます。情報の要求を処理し、情報の変更を即座に送信できます。リアルタイムのAIサービスに統合できるため、ヘッドレスコンテンツを変更、変換、および再形成できます。たとえば、画像をAPIで処理して、フレーミングを変更できます。 、着色、またはその他のプロパティをその場で。

10.DITAはコンテキストを取得しません。ヘッドレスは

DITAはドキュメント化アプローチであるため、ユーザーの行動やコンテキストに基づいて変更する必要のある動的コンテンツ向けには設計されていません。これは、顧客がますます期待するものです。代わりに、 DITAは事前定義されたコンテンツパッケージを出力するように設計されています。流動的な状況やターゲットを絞った情報の要求に対応するためにコンテンツを調整する必要がある場合、これは悪いアプローチです。起こりうるすべての不測の事態を計画し、各不測の事態に対処するために複数のバージョンを作成する必要があります。それでも、すべてを計画したかどうかはわかりません。結果は目標外になります。

ヘッドレスコンテンツは継続的に更新できます。動的できめ細かく、ユーザーが受け取る詳細はコンテキストに固有である可能性があります。たとえば、ヘッドレスはIoTアプリケーションで使用され、場所での人の存在に基づいてコンテンツを提示します。ジェスチャー、動き、他の人との距離などです。物事。

11. DITAは、コンテンツをその方法で管理することを強制します。ヘッドレスを使用すると、コンテンツを自分のやり方で管理できます

DITAは、コンテンツの構造に厳格なフレームワークを課します。企業は、さまざまなコンテンツ構造を使用する必要がありますが、さまざまなコンテンツを限られた数の認識された情報タイプに分類する必要があり、ニーズに適さない場合があります。そうでなければ、DITAの複雑なドキュメントタイピング定義システム内でカスタム情報タイプを開発するという厄介な負担に直面します。多くの企業は、DITAのデフォルトの情報タイプのカバレッジが、技術ドキュメントではない多くの種類のエンタープライズコンテンツには不十分であることを発見しています。それでも、DITAでの情報タイプのカスタム開発の煩わしさは高すぎます。

ヘッドレスは異なるアプローチを取ります。標準を課すのではなく、オープンアーキテクチャに基づいています。さまざまな発行元が、ニーズに合わせてカスタマイズできるようにコンテンツをどのように構成するかを自分で決めることができます。コンテンツタイプの開発は簡単です。 DITAアプローチと比較して。

ヘッドレスはより良い方法です

何年も前に、コンテンツストラテジストのSara Wachter-Boettcherは、広く読まれているA List Apartの記事で、コンテンツを将来に備えたものにする必要性について話しました。彼女は、ヘッドレスコンテンツ管理の早期採用者であるNational Public Radio（NPR）の経験を次のように引用しました。コンテンツを将来に備えて準備する方法の有益な例。彼女は次のように述べています。「テクニカルコミュニケーターは何年もの間DITA（Darwin Information Typing Architecture）を推進してきましたが、特に未来的なものはありません...多くのテクニカルコミュニケーターはDITAをWebの標準的な構造化アプローチにするべきだと主張していますが、完全に普及することはありません。それを行う唯一の方法でもありません。」

今日、ヘッドレスコンテンツ管理が主流になりました。構造化コンテンツを管理するための最も実行可能なアプローチを提供します。ライターと開発者の両方が、ヘッドレスによってそれぞれの責任に集中できることを高く評価しています。どのような種類のコンテンツを扱う場合でも、ヘッドレスを使用すると管理しやすくなります。