Отчёт за два месяца сразу. Основной "выхлоп" в эти два месяца пришёлся на курс Контент-менеджер. Добавлено много уроков и видео. Вся остальная работа - типовая: обновление доки под новый функционал. Подробности под катом. [spoiler] Документация API Новое
в плане скачивания страниц документации - работает все криво (использую getpocket.com) можно ли сделать уже адекватный ресурс - чтоб скачивать можно было?
а поддержке для мобильных устройств и работы в оффлайне мечтать не приходится. может тогда выкладывайте хотя бы полную документацию в старом добром html а? это веть не так сложно.
Что начали делать документацию по классам компонент инфоблоков - хорошо. Конечно, если есть понимание, что это только начало.
Чего не хватает по уже написанному - в моем комментарии к странице документации:
Не хватает расшифровок по каждому из уже указанных (даже по ним) методов.
К примеру, что такое расширенный режим? Что за постфиксное время такое? "SKU_PRODUCT_ID => PRODUCT_ID" выглядит маслом масляным. Что там на самом деле и для чего? Что за фокусы с кешем задуманы? Как он вообще управляется? Как, для чего используется AJAX? Как это связано (связано ли вообще) с AJAX режимом работы компонент (это из движка компонент)?
Пока это традиционная отписка в стиле "документация есть". Но ее все еще нет. Это заготовка, сигнал тому, что кто-то вообще начал ее делать.
Скорее всего, это приведет к обзорной статье с описанием основных зависимостей и закономерностей. Может быть с примерами кода.
в целом создается ощущение что документация пишется для каких то 1C-ников которые сидят на windows xp
а тестировали верстку документации наверное в IE 6
сейчас чтобы прочитать на мобильном устройстве я распаковываю 7zip chm и удаляю стили - даже настройки браузера "Спец возможности" не помогают все равно местами текст мелкий
можно ли сделать уже адекватный ресурс - чтоб скачивать можно было?
а поддержке для мобильных устройств и работы в оффлайне мечтать не приходится.
может тогда выкладывайте хотя бы полную документацию в старом добром html а?
это веть не так сложно.
это Windows формат
только что скачал чтобы убедится
Это для андроид, для "яблока" тоже что-то есть, мы тестировали.
так вот чтобы эти html не выкладывать в виде zip архива как это делают практически все
в чем проблема то?
документацию не только с десктопа читают и не только в Windows
реализовать канал в yandex zen не сложно - а читать на мобильных устройствах будет очень удобно
пример
Чего не хватает по уже написанному - в моем комментарии к странице документации:
К примеру, что такое расширенный режим?
Что за постфиксное время такое?
"SKU_PRODUCT_ID => PRODUCT_ID" выглядит маслом масляным. Что там на самом деле и для чего?
Что за фокусы с кешем задуманы? Как он вообще управляется?
Как, для чего используется AJAX? Как это связано (связано ли вообще) с AJAX режимом работы компонент (это из движка компонент)?
Пока это традиционная отписка в стиле "документация есть". Но ее все еще нет. Это заготовка, сигнал тому, что кто-то вообще начал ее делать.
Скорее всего, это приведет к обзорной статье с описанием основных зависимостей и закономерностей. Может быть с примерами кода.
2 пространства имен, 2 класса и 4 метода это вся документация по модулям интранет и реклама?
А в целом
а тестировали верстку документации наверное в IE 6
сейчас чтобы прочитать на мобильном устройстве я распаковываю 7zip chm и удаляю стили - даже настройки браузера "Спец возможности" не помогают
все равно местами текст мелкий