Возможно, это не считается реальным ответом:
Я бы проголосовал против этих файлов справки. 5-6 лет назад у нас были реальные контекстно-зависимые файлы справки для каждого диалогового окна в наших приложениях, и это было много усилий по их поддержке.
Поэтому мы изменили это на доставку «простых» файлов PDF, которые появляются на F1. Мы никогда не получали жалоб от пользователей.
Недавно мы начали переносить это на настоящие HTML-сайты с большим количеством отдельных страниц, функцией поиска, навигацией «предыдущая» и «следующая», а также в формате, удобном для печати. Это позволяет нам обновлять руководство намного быстрее и делает его более «связываемым» по сравнению с PDF.
Лично я действительно никогда не согреюсь с этими справочными файлами. Например. Я до сих пор не понимаю, почему некоторым файлам нужно доверять, прежде чем я смогу открыть и просмотреть их.