Пользовался до недавнего времени CHM - просто там удобнее искать и быстрее по дереву разделов ходить. Но после обновления макоси до 10.15 любимый ридер сломался, а альтернатива кажет оглавление в utf-8, а текст - в cp1251. Надоело постоянно переключать кодировки, пришлось переходить в веб. Даже начинал делать доксет из онлайн-документации для https://kapeli.com/dash, но как-то незаметно забилось.
Не пользуюсь оффлайн. Было бы лучше сделать вам phpdoc для ide. Что-то типа такого https://github.com/matiaspub/bxApiDocs + подключить разные версии модулей чтоб можно было отслеживать изменения в коде ядра и переключать различные версии
Спасибо всем. Вывод, похоже такой: оффлайн дока нужна, но нужно искать другой формат. Для нас проблема в том, чтобы максимально автоматизировать этот процесс. Пробовали с fb2, но пока что-то не очень.
Офлайн документация конечно нужна, и, что самое важное, она должна быть хорошо читаема с мобильных устройств (когда в дороге, или в отпуске без интернета). В случае с интернетом - удобней открыть сайт в браузере. Спасибо за ваш труд!
Бывает, редко. Удобно когда нет доступа к интернут. Но формат вообще документации очень не удобный ;( Для mac os нет нормального ридера для просмотра chm
chm не предлагать
Было бы лучше сделать вам phpdoc для ide. Что-то типа такого
+ подключить разные версии модулей чтоб можно было отслеживать изменения в коде ядра и переключать различные версии
Вывод, похоже такой: оффлайн дока нужна, но нужно искать другой формат.
Для нас проблема в том, чтобы максимально автоматизировать этот процесс.
Пробовали с fb2, но пока что-то не очень.
Проблему вы засветили, Благодарю!