Не пора ли пересмотреть файловую систему справки Delphi?

Большинство компонентов, доступных для Delphi, не имеют файлов справки HTML для Delphi 2009. Многие компоненты, включая некоторые очень популярные коммерческие компоненты, имеют только файлы справки HLP и CHM.

Многие из сторонних компонентов больше не активно разрабатываются, а используются многими разработчиками. В результате для этих компонентов отсутствует поддержка IDE.

Было очень мало жалоб на старые файлы справки CHM, но сегодня есть много жалоб на файловую систему справки. Возможно, настало время для Codegear переосмыслить тип используемой файловой системы справки.

Одна из жалоб, которые у меня есть, даже когда вы устанавливаете компоненты, которые предоставляют файлы справки HTML, вкладка "Содержание" повреждается, когда ранее установленное содержимое компонента удаляется.

Возможны ли альтернативы для Codegear?

ОТВЕТЫ

Ответ 1

У меня такое же чувство. Старая справочная система помогает мне быстрее найти ответ.

Ответ 2

Одна идея состоит в том, чтобы, возможно, смоделировать ее после Delphi Wiki по адресу: http://delphi.wikia.com/wiki/Delphi_Wiki

Вики фактически не настроены так плохо, особенно с ссылкой VCL в левом фрейме.

Довольно приятно смотреть, имеет достойный поиск, включает вопросы, примеры, перекрестные ссылки и то, что мне больше всего нравится: комментарии и советы пользователей.

Собственно, касаясь комментариев и советов пользователей, мне больше всего нравится документация по PHP на www.php.net/docs.php (что, я думаю, - лучшая программная документация, которую я видел) - это комментарии и советы пользователей.

Если они могут интегрировать отличный макет, который вы найдете в Delphi Basics, и разрешите сторонним компонентам добавлять свою помощь файлы в него, то они будут иметь полную ссылку. (Но третьим сторонам, очевидно, придется реструктурировать свои файлы справки в новый формат - независимо от того, в чем он заканчивается).

В вики также есть разделы для учебных пособий, советов и трюков, ссылок и популярных статей. И я думаю, что это также может стать всеохватывающим кодовым хранилищем, который нам всем хотелось бы.

Разрешить загрузку вики-справки необходимо, чтобы доступ к ней можно было выполнять офлайн.

И им нужно будет выяснить, как заставить клавишу F1 работать, чтобы правильно искать файл wiki/help, будь то онлайн или офлайн, и дать наиболее релевантные результаты.

Проблема с Wiki теперь заключается в том, что она не является полной, и полный набор файлов справки Delphi необходимо включить в нее.

Это может быть конвейер, но что-то вроде этого будет моим идеалом.

Ответ 3

Это домашняя ненависть. Справка Delphi только ухудшилась, хотя с недавним небольшим улучшением. Я честно считаю, что это одна из вещей, сдерживающих ее принятие.

Ответ 4

Micosoft представила Help3 для VS2010, поэтому, возможно, мы увидим ее и в Delphi:

Вот сообщение в блоге, которое отвечает на вопрос "Почему новая справочная система?"

http://thirdblogfromthesun.com/2010/10/the-story-of-help-in-visual-studio-2010/

Он цитирует внутреннюю статью, которая привела к созданию нового проекта "Help3" в начало 2008 года:

"В документе описаны следующие проблемы с опытом работы в Visual Studio:

  • Невозможность найти нужную вам информацию является общей проблема. Справка F1 и поиск не как и должны.
  • Производительность справочной системы - в первую очередь, запуск, тема-загрузка, локальные результаты поиска - это один из самые большие проблемы.
  • Установка автономной библиотеки MSDN является хрупкой из-за сложности справочная система.
  • Проприетарный характер нашего формата помощи не дает партнеров для разработки инструментов разработки и не может быть легко разработчики в своих продуктах.
  • На стороне создания контента справочная платформа оседлает нас устаревшие инструменты и процессы.
  • Наконец, и самое главное, ни одна команда в Microsoft не имеет права решать эти проблемы."