最近、ヘルプファイルとは何が関係していますか？

Question

ユーザーの視点でthis question at SuperUserを追加しました。

私はデスクトップシステム上で動作するDelphiまたは.NETでアプリケーションを作成します。すべての種類の機能と素敵な機能を備えた素敵なGUIです。それはうまく動作し、テストはバグがほとんどないと言います。私はそれを展開しようとしています...

WAIT！ヘルプファイルが必要なので、ユーザーは状況依存のヘルプをアプリケーションから呼び出すことができます。

そうではありませんか？デスクトップアプリケーションではヘルプファイルが本当に必要ですか？そして、彼らは実際に状況に敏感である必要があります、 "誕生日"と表示されているこのフィールドで、彼らが出生の日を記入する必要があることを彼らに伝えるためにユーザーの手を握っていますか？または、ヘルプファイルが古くなってきていますか？

これは私が不思議なことですが、これはちょっと主観的なものなので、デスクトップアプリケーションを開発する皆さんには、何か別のことを尋ねます：状況依存のヘルプファイルを提供していますか？

はい、いいえ、してください。主観的なテキストを自由に追加しても構いませんが、現代の開発者がGUIアプリケーションに状況依存ヘルプを追加しているかどうかを知ることが重要です。

は（ところで、私自身は、マニュアルとして印刷することができる非コンテキストのPDFファイルに移動してきた。それは維持するために非常に簡単です。）

Answer 1

はい、あります。

理由： 私は、ユーザーにプログラムの仕組みを知らせることはできません。 [OK]を「誕生日」フィールドに入力する必要があることを説明するのは少し極端ですが、通常はソフトウェアシステムにはもっと複雑なものがあります。ちょうど今日の原価計算システムのヘルプファイルを書いて、計算に使用すべき価格を決定するシステムがどのように機能するかを説明しなければなりませんでした。私はどのユーザーもこのヘルプファイルを使用してシステムを構成する方法を知っているとは思わない。

Answer 2

我々は現在ありませんが、我々は多くのことを書いていませんのWindowsアプリ。ほとんどがウェブベースです。私たちのWindowsアプリケーションのほとんどは、かなり小さく、ヘルプファイルの外に文書化されています。

また、エンドユーザーは開発プロセス中にドキュメントを作成するので、ドキュメントは理解できるものです。

しかし、（内部アプリではなく）大量のアプリを作成していた場合は、状況依存のヘルプファイルを追加します。私は過去にいくつかのより大きなアプリについてこれを行ってきましたが、非内部状況では非常に役立ちます。

実際には、私たちのウェブサイトは、状況依存型の「必要なヘルプ」機能を持つように設計されており、その機能は好評を博しています。弊社のWebサイトでも社内でも、Web開発のすべてにこれを組み込んでいます。

Answer 3

私はアプリケーションで文脈依存ヘルプを提供したことはありませんし、他のアプリケーションでもそれを自分で使用するのに十分な実装は見ていません。私の意見では、それをうまくやる努力が利益を上回っています。

私は最後に、この決定を行う必要があったアプリケーションに、アプリケーションでツールチップの吹き出しを使用しました。この吹き出しは、ユーザーが各コントロールにカーソルを合わせたときにテキストの吹き出しを表示します。我々はまた、多くのステップバイステップのスクリーンショットを伴うウォークスルーである従来のマニュアルを提供した。

しばらくして、ユーザーがバルーンに気をつけて、私たちが提供したチェックボックスをオフにしましたが、初心者の手助けとなりました。

Answer 4

私はあなたに私の個人的な味が他の事実によって支持されていない、個人的な意見を与えます。

ヘルプファイルを書くことは、すべてが新しいものであり、オンラインリソースが不足していた過去において有用でした。今日、ほとんどのコンピュータユーザーは直接探査によって学びます。ツールヒントの形での文脈ヘルプは非常に強く推奨されています。これはこの探索的学習のヒントを与えます。

多くのリンクをクリックしてヘルプドキュメントをご覧になれますか？まあそれは明らかに素晴らしいですが、私が推測することはめったにありません。ほとんどの場合、ユーザーは適切なGoogle検索で回答を得ることができます。さらに、この種のドキュメントは高価なです。開発者が書くことはできません。これには特定の人材を雇うか配属しなければなりません。技術的な記述と明確なスキルが必要です。

この決定を管理しなければならない場合は、非常に難解で特別な（私はユニークだと言っています）あなたのアプリケーションに対しては、完全なドキュメントを提供します。いずれにしても、私はコンテキストヘルプファイルではなく、オンラインチュートリアルの傾向があります。これには、アプリケーションを使用するのがどれほど難しいか、最も要求の多いホットスポット（オンラインドキュメントへのヒットと参照元の検索クエリを評価すること）についての情報を提供するという追加の利点があります。

Answer 5

最近のアプリケーションでは、状況依存ヘルプを提供していませんでした。これは何か他の技術的な理由がありませんでした（ヘルプファイルは本質的に、多言語ドックファイルです。理論上は状況依存ヘルプをサポートしていますが、うまく機能しませんでした）。アプリケーション内の各ウィンドウ/ダイアログごとに1ページあり、すべてのコントロールが説明されています。しかし、各コントロールにはかなり包括的なツールチップがあり、ほとんどの場合、追加のヘルプが不要になります。各ダイアログには、ダイアログ固有のページを表示するためのヘルプボタンがあります。歴史的には、ヘルプファイルにツールヒントテキストを保存することはできましたが、それは最近のヘルプシステムでは機能していないようです。とにかく彼らはリソースに保存されています。

しかし、それは誰のためのアプリケーションでもありません。アプリケーションで管理できるネットワークシステムは複雑なトピックなので、ユーザーのための特別なトレーニングがあり、ネットワークシステムを知っていればアプリケーションも知ることができるようにアプリケーションが設計されています。言い換えれば、アプリケーションモデルはユーザーモデルと整列しているので、包括的なヘルプ機能は必要ありません。これは、あらゆるアプリケーション開発の目標です。

コントロールに関するヘルプファイルのほとんどの情報は、ツールチップに既に記載されている情報よりも多くはありません。

OfficeとVisual Studioでは、似たような問題が解決されました。ヘルプを押すと、単一のコントロールではなくダイアログ全体のヘルプページが開きます。

ダイアログが複雑で、追加の説明が必要な場合（また、簡単にするために再設計できない場合）、コントロールのすぐ隣に説明を置くことができます。これは、特殊なケースのために多くのアプリケーションで使用されているため、ユーザーは例えばユーザーが検索しなければならないためにワークフローが中断されません。特定のテキストがどのように書き込まれなければならないか。

Answer 6

開発者ではなく、ユーザーと言えば - はい、状況依存ヘルプファイルが必要です。

たとえば、私は現在、新しいプロジェクトに含めるサードパーティコントロールを評価しています。状況依存ヘルプ（context sensitive help）の良いコントロールプロパティウィンドウでプロパティを選択したり、コード内のキーワードを選択したり、F1キーを押してヘルプトピックに直接進むことができます。

Answer 7

すべてのアプリケーションは、アプリケーションのすべての重要な機能について、ツールチップ（Office 2007のヒントに似ています）の形で状況依存ヘルプを備えています。

伝統的な本格的なヘルプファイルは提供していませんが、私たちは定期的に更新するナレッジベースを持っています。これは、電話、電子メールなどを介して、すべての問題について適切に分類され、容易に検索可能であることをクライアントに提供するすべてのヘルプの集まりです。これは最終的には、クライアントが何を探すのではなく、何が含まれているかのベスト・ヘルプに終わります。は当初必要と思われると思います。

ナレッジベースを一目で気にせずにいくつかのクライアントがいつも私達に連絡を取りますが、それでも車輪の時間をやり直すことはありません。

Answer 8

ツールチップと一般にユーザーのコンピュータ能力が向上しているため、ヘルプファイルがないとうまくいくアプリケーションもあります。しかし、アプリケーションの中には一般的なトピック情報と同様にヘルプファイルが必要なものもあります。たとえば、写真アプリでは、ユーザー操作が自明であっても、jpeg圧縮を説明し、ヘルプファイルにいくつかのサンプルを含めることができます。

マイクロソフトは状況に応じたヘルプの低下に貢献しているようです。最初に、Visual Studioのヘルプシステムは、軽くするために、使用する痛みです。次に、Visual Studioのヘルプシステムの使い易さが大幅に低下しました。私は暴言を省略しますが、多くのクリックとスクロールがVS2008ヘルプの関連情報を取得するのにかかると言うには十分です。これは、アプリケーションのヘルプシステムの標準を低く設定する傾向があります。

Answer 9

ヘルプがありません。これは、技術的に傾きがちで、新しいソフトウェアで遊びたい人にとってはうれしいことです。しかし、あなたのソフトウェアが技術に精通していない人々によって使用される場合、ヘルプが不可欠です。日付のあなたの例を挙げる。国際市場をお持ちの方は、プログラムに必要なものを詳しくお聞かせください。アメリカ人はMM/DD/YYYY形式を使用しますが、ほとんどの国際ユーザーはDD/MM/YYYYを使用します。あなたはプログラムが必要とするものを綴る必要があります。

私は、エンドユーザーとその操作方法について全く知らない多くの開発者と協力してきました。たとえば、新会社を訴えたCTOは、アップデートがあるたびに顧客がすべてのPDFとヘルプトピックのほとんどを印刷したことを知らずに、印刷可能なドキュメントをなくすべきです。エンドユーザーと市場を知る必要があります。残念ながら、あまりにも多くの開発者がバブルの中に住み、他の開発者に囲まれています。

開発者はヘルプを書く必要がありますか？おそらくそうではありません。あなたの典型的なエンドユーザーのように考えることはできませんが、テクニカルライターはテクニカル情報をエンドユーザーが必要とするレベルまで下げることができます。