В этом коротком месяце основная работа была по обработке статистических данных итоговых анкет при сдаче тестов в наших учебных курсах. Подробности под катом. [spoiler] Не ожидали такого большого отклика, спасибо всем ответившим. Обработка ваших данных заняла много времени.
По результатам обработки анкет сделаны выводы, часть работ уже проведена. Например, удалён из списка тестов курса Контент-менеджер тест по работе с модулями "1С-Битрикс: Управление сайтом". Этот тест не давал никаких дополнительных знаний, а лишняя нагрузка в и так в большом курсе только мешала.
Будут и другие изменения, всё в работе. Все ваши голоса услышаны. Правда не всё из того что вы пожелали можно сделать либо можно быстро сделать. Но мы будем стараться.
Роберт, много раз поднимавшийся вопрос от коллег: форматирование кода в документации.
Можете ли вы стандартизировать подход к оформлению? Сейчас такое впечатление что вы вообще этим не паритесь - как разработчик дал, вы просто бездумно скопипастили в документацию и не подумали о форматировании кода.
В итоге у нас в каждом разделе рандомно отформатированный код 1. В одном разделе у вас отступы табами (причем огромные на 8 символов) 2. В другом разделе пробелы, причем не 2, ни 4, а 3. 0_о 3. В одном разделе скобку переносите в методах, в другом нет.
Есть инструмент phpcsfixer. Есть форматирование phpstorm. Есть стандарт PSR2/12. На худой конец использовать битриксовый стандарт. Но будьте последовательны. Форматирование кода - это лицо документации.
Или скопом пробежаться по всем вставкам кода и запустить форматирование (рекомендуется) или запустите тогда компанию по ручному причесыванию.
Нет ни 1 фреймверка или CMS с таким же неряшливым отношением к коду в документации.
День добрый! Да, Иван, вы правы, мы просто копипастим: банально не хватает времени за всем уследить. Займёмся исправлением этого в ближайшее время, вроде появились возможности.
Примеры некорректно отображаются, описание тоже raw html<br>
Можете ли вы стандартизировать подход к оформлению? Сейчас такое впечатление что вы вообще этим не паритесь - как разработчик дал, вы просто бездумно скопипастили в документацию и не подумали о форматировании кода.
В итоге у нас в каждом разделе рандомно отформатированный код
1. В одном разделе у вас отступы табами (причем огромные на 8 символов)
2. В другом разделе пробелы, причем не 2, ни 4, а 3. 0_о
3. В одном разделе скобку переносите в методах, в другом нет.
Есть инструмент phpcsfixer. Есть форматирование phpstorm. Есть стандарт PSR2/12. На худой конец использовать битриксовый стандарт. Но будьте последовательны.
Форматирование кода - это лицо документации.
Или скопом пробежаться по всем вставкам кода и запустить форматирование (рекомендуется) или запустите тогда компанию по ручному причесыванию.
Нет ни 1 фреймверка или CMS с таким же неряшливым отношением к коду в документации.
Да, Иван, вы правы, мы просто копипастим: банально не хватает времени за всем уследить. Займёмся исправлением этого в ближайшее время, вроде появились возможности.
Спасибо за неравнодушие.