По поводу SDK ...

[Rikhter]

Уважаемая администрация!
Мне бы хотелось уточнить причину по которой документация к Вашему SDK до сих пор распространяется в формате исполняемых HTML-справок? В чём проблема разместить её в виде полноценного онлайн раздела на сайте? Ибо в реалиях сегодняшнего дня такой способ распространения выглядит откровенно архаичным и создаёт ощущение, будто мы всё ещё живём во времена Windows 98. Работать с подобным форматом, мягко говоря, крайне неудобно ...

[Soolo]

В реалиях сегодняшнего дня онлайн - штука нестабильная

[Artem]

Ибо в реалиях сегодняшнего дня такой способ распространения выглядит откровенно архаичным и создаёт ощущение, будто мы всё ещё живём во времена Windows 98

А если по делу? Чем CHM неудобен?

[Black_AVP_Bim]

ИМХО, в оффлайне со справкой работать удобнее, единственная беда всех CHM - примитивный поиск.

[Artem]

единственная беда всех CHM - примитивный поиск

Это да, а современные форматы справок требуют дополнительного софта, к сожалению...

Я не стал делать онлайн справку по двум причинам:
1) скачать SDK недостаточно - нужен онлайн
2) SDK у нас несколько - с каждым из них идёт определенная версия справки. Если делать онлайн справку - может возникнуть путаница с версиями - скачали SDK для одной версии, а справку открыли для другой - и ничего не работает.

[«G-Li†ch»]

А я не люблю такие CHM (а PDF и подавно), где жётско прописаны bgcolor="#FFFFFF", из-за этого приходится ставить галочку в "Свойства обозревателя…" — Оформление — "Не учитывать цвета, указанные на веб-страницах" (или может в политиках каких ещё что-то), хотя и это изредка приводит к небольшим неудобствам… Особо тяжёлые случаяи, когда определённые .chm запрещают hh отображать нужные элементы окна (кнопки или какие-нибудь панели) — вроде и попался какой-то "редактор" таких "атрибутов", но что-то мне им не удалось исправить такие .chm`ки (чаще они вообще ломались), и, соответственно, выходит как у "старого доброго .hlp" — даже страницу никак не отмасштабировать! HTML (для банального просмотра в ишаке) в этом плане хотя бы предпочтительнее, но, вспоминая, как погано оно сделано у LibreOffice, то не знаю, что лучше
Не идеальный и .h1s (да и инструментов для их создания нет в открытом доступе — ждём слива исходиков висты/7ки, да и с их "открытием" такая же проблема, как со справкой VisualStudio 2005/2008), но этот хотя бы интереснее, да и поприятнее чтоль… MSHelp2 — наихудший сценарий
Я не против DOS-варианта (да даже для qh, хотя я его тоже не понимаю…), но лучше, чтоб можно было читать прямо из-под консольного FreePascal IDE

[Rikhter]

CHM

Мне как WEB разработчику привычен онлайн формат, поэтому привык использовать документацию прямо в браузере и в этом есть свои плюсы, ибо там удобнее поиск, проще ориентироваться между версиями библиотек, а ещё есть возможность запускать код в песочнице и сразу проверять примеры из доки, что сильно ускоряет изучение. Кроме того, web-документация проще обновляется и лучше интегрируется с поиском и современными инструментами разработки по сравнению с CHM.

[Artem]

Мне как WEB разработчику привычен онлайн формат, поэтому привык использовать документацию прямо в браузере и в этом есть свои плюсы, ибо там удобнее поиск, проще ориентироваться между версиями библиотек, а ещё есть возможность запускать код в песочнице и сразу проверять примеры из доки, что сильно ускоряет изучение. Кроме того, web-документация проще обновляется и лучше интегрируется с поиском и современными инструментами разработки по сравнению с CHM.

Это всё верно, но только оно не применимо к нашему случаю. Про обновление документации я уже сказал выше - она обновляется только с обновлением самого SDK.

[Artem]

А я не люблю такие CHM (а PDF и подавно), где жётско прописаны bgcolor="#FFFFFF", из-за этого приходится ставить галочку в "Свойства обозревателя…" — Оформление — "Не учитывать цвета, указанные на веб-страницах" (или может в политиках каких ещё что-то), хотя и это изредка приводит к небольшим неудобствам… Особо тяжёлые случаяи, когда определённые .chm запрещают hh отображать нужные элементы окна (кнопки или какие-нибудь панели) — вроде и попался какой-то "редактор" таких "атрибутов", но что-то мне им не удалось исправить такие .chm`ки (чаще они вообще ломались), и, соответственно, выходит как у "старого доброго .hlp" — даже страницу никак не отмасштабировать! HTML (для банального просмотра в ишаке) в этом плане хотя бы предпочтительнее, но, вспоминая, как погано оно сделано у LibreOffice, то не знаю, что лучше
Не идеальный и .h1s (да и инструментов для их создания нет в открытом доступе — ждём слива исходиков висты/7ки, да и с их "открытием" такая же проблема, как со справкой VisualStudio 2005/2008), но этот хотя бы интереснее, да и поприятнее чтоль… MSHelp2 — наихудший сценарий
Я не против DOS-варианта (да даже для qh, хотя я его тоже не понимаю…), но лучше, чтоб можно было читать прямо из-под консольного FreePascal IDE

К чему это было? 🤔

[DarkDrawKill]

а ещё есть возможность запускать код в песочнице и сразу проверять примеры из доки, что сильно ускоряет изучение.

кроме программирования с использованием компонентов виндовс (винапи) там и изучать ничего
+ какой вы код собираетесь запускать в песочнице это плеер а не питон там все функции симулировать придётся

[DarkDrawKill]

хотел дописать но свет вырубили так и забыл

короче... я ненавижу онлайн документации и им подобным когда интернет вырубают а ты пишешь программу (да лабораторной например) а перед тобой документации нет а не каждый разработчик позволяет качать страницу для печати (обычные html разваливаются даже в браузерах не говоря об емаксе и подобных читалок) chm это дарование и дерево есть и хоть какой никакой да поиск