「ドキュメント」 vs 「ドキュメンテーション」
Closed this issue · 3 comments
ドキュメント
281:
828:
844:
A.4.2.2 すべての機能のドキュメント化:
847:
1294:
ガイドライン B.4.2: アクセシブルなコンテンツの制作を促進するドキュメントを確保する。
1670: ドキュメントオブジェクト (document object)
1671: 非ウェブベースのオーサリングツール又はユーザエージェントによるソース内のデータの内部表現。ドキュメントオブジェクトは支援技術とのやりとりを可能にするプラットフォームのアクセシビリティサービスの一部を形成する。 ウェブベースのオーサリングツールはユーザエージェントが管理するドキュメントオブジェクトを利用してもよい。
1723: アプリケーションと支援技術間のやりとりを提供するため特別に設計されたプログラムによるインタフェース (WindowsアプリケーションだとMSAA、IAccessible2、UI Automation、Mac OS XアプリケーションではAXAPI、GNOMEアプリケーションでは、GNOME Accessibility Toolkit API、JavaアプリケーションではJava Accessなど)。いくつかのプラットフォームではドキュメントオブジェクトを実装することによって、従来のやりとりをさらに強化してもよい。
1733:
1749:
1762: 注記 4: "デフォルト状態" は、開発者により設定されたオーサリングセッション開始時のオーサリングツールの状態である。 多くのドキュメントオーサリングツールのデフォルト状態は編集ビューである。
ドキュメンテーション
393:
401:
821:
根拠: 一部のコンテンツ制作者は、ドキュメンテーションなしにオーサリングツールのユーザインタフェースを理解したり操作することができない場合がある。
828:
834:
847:
853:
877:
1303:
ドキュメンテーションに含まれる実例の集まりは、アクセシブルなオーサリングの慣例 (WCAG) (例えば、マークアップや、WYSIWYG の編集ビューのスクリーンショットなど) を示す。(レベル A は WCAG 2.0 のレベル A の達成基準; レベル AA は WCAG 2.0 のレベル A と AA の達成基準; レベル AAA は WCAG 2.0 のすべての達成基準を満たす)
1316:
すべてのアクセシブルなコンテンツを支援する機能の使用方法はドキュメンテーションに記載されている。(レベル A)
1335:
オーサリングツールのドキュメンテーションは、アクセシブルなコンテンツのサポート機能を使用するための説明の索引を含む。(レベル AAA)
1530:
1667:
そもそもATAG 2.0原文からして、documentとdocumentationが混在しているようです。統一する必要がどうか、というところからでしょうか?
documentation は定義された用語なので、
https://www.w3.org/TR/2015/REC-ATAG20-20150924/#def-Documentation
Any information that supports the use of an authoring tool. This information may be provided electronically or otherwise and includes help, manuals, installation instructions, sample work flows, tutorials, etc.
これはわざと使い分けているのかもしれないですね。
一旦このままにしておきましょう。