Работа над Учебками

Работа над Учебками -- это вики-страница, созданная и существующая для работы над Брацкой, Курсовой и Будущей Учебками. Вместе эти три прилады далее именуются Учебками.

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

Координация

Координаторы организуют работу над Учебками. Последовательность заданий координаторам:

Сформулировать требования к Учебкам
Администрировать Учебки
Работать с подрядчиками
Дорабатывать инструкции координаторам

Требования к Учебкам

Определить, что мы собираемся предлагать ученикам в качестве прилад под именами бренда Учебок и как мы собираемся предлагать. Для этого:

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

Так как прилад три, то и страницы три; по одной странице на каждую приладу. Эти страницы нужны тем, кто работает над Учебкой, чтобы знать, что должно в итоге работы получиться. Координаторов могут попросить объяснить, что там написано. При это он должен уметь изложить суть требований подрядчику.

Есть два вида робот над требованиями это доработка существующих и создания новых. Основными источниками информации для требований есть сторона заказчика, отзывы учеников, собственные наблюдения, анализ документации и общение з подрядчиком. Задача координаторов состоит в соборе информации и ее документировании. Для ее сбора на проекте используются еженедельные разговоры, конференции и переписки. Документировать лучше все, потом лишнее можно удалить, это лучше чем что то упустить. Не забывать ставить пометки источника требований, так как они могут не совпадать с мнением заказчика. Возникшие вопросы желательно тоже документировать, до получения на них ответов.

Администрация Учебок

Что можно поправить на Учебках самим -- поправить. Документация на проекте должна быть понятна даже тем кто ничего не слышал о нем. В случае использование терминологии проекта, нужно использовать использовать внутренние ссылки на его определение или страницу.

Работа с подрядчиками

На данной странице описания работ, мы разрабатываем, что нам надо сделать для того, чтобы претворить в жизнь Требования к Учебкам. Координаторы уточняют детали разработок и предлагают план действий над тем, что невозможно поправить самим и на что нужны подрядчики. Эти планы могут включать:

критерии найма подрядчиков,
тексты объявлений на их поиск,
список вебсайтов и других инструментов для размещения объявлений,
порядок отбора подрядчиков,
тексты договоров,
порядок адаптации на работах, а также
координации работы и завершения работ.

На работу с Учебками стоит рассматривать одного постоянного подрядчика на плановые работы Обслуживание операций, и отдельных подрядчиков на Разовые работы. Это условие не запрещает постоянному подрядчику работать на разовых работах. Подрядчики наниматься на основании требований, изложенных на этой странице, после прохождения собеседования и отбора. В отборе преимущество имеют те кандидаты которые готовы выполнить требования за минимальный бюджет. В результате положительного собеседования должны быть доработаны требования. С подрядчик заключаться договор [[1]]. Основным сайтом для поиска подрядчиков будет upwork.com, но стоит разместить объявления и на украинских ресурсах таких как work.ua либо robota.ua. Основным критерием отбора будет возможность подрядчика реализовать требования. Подрядчик который будет нанят на плановые работы будет их выполнять с некой периодичностью. Например, с выходу новой стабильной сборки Moodle.

Инструкции для координаторов

Дорабатывать инструкции для следующих координаторов.

Обслуживание операций

Обеспечить плановое обновление версий на Moodle.Обновление версий на нужно проводить на Будуща Учебка "экспериментальной" приладе. После обновлений нужно провести тестирование для выявлении проблем функционала. Основная версия обновляется после того как экспериментальная версия пройдет тестирование.
Обеспечить тестирование функционала после обновлений. Имеет смысл создания функциональных тест кейсов для проверки Будуща Учебка. Так как "выращивать" тестировщиков Gary не видит необходимость, до выполнение тест кейсов, непосредственного тестирования, можно залучать учеников школы, как практики на проекте. Можно предлагать ученикам обучение у партнёров в этом направлении. Координаторы могут собирать и анализировать свидине от учеников, для исправления проблем. Либо воспользоваться услугами подрядчиков.
Обеспечить плановый специализированный мониторинг приложения.

Разовые работы

Картинки

При отображении на десктопе должны занимать 50% экрана, на мобильных устройствах - 100%. А так же иметь подписи и открываться в отдельном окне.
Разрабатываются в формате .svg, однако должны конвертироваться вручную в .png из-за отказа системы работать с .svg форматом.
Возможно, следует собрать в определенном репозитории, а на остальных ресурсах при вставке картинок ссылаться на него. Для картинок на Брацкой Правке рассматривается использование Вики-склада. Надо рассмотреть возможность объединить эти две разработки.
Существует проблема инструкций по работе с картинками. Инструкция висит на сообществе координаторов, но не понятно, почему там, как о ней узнать и как получить.

Учебный элемент "Лекция"

Нет возможности скачивать, обрабатывать и выводить ответы. Некоторые из ответов, например, эссе, планируется связывать с профилем ученика.
Есть интерес использовать кластеры страниц, но нет опыта.
Для отзывов используются информационные страницы типа "Список разделов"; стандартные инструменты отзывов элемента не используются. Однако если управляющий курса по ошибке вставляет текст в стандартное поле отзыва и затем вставленный по ошибке текст удаляет, система продолжает отображать стандартный отзыв, который к тому времени уже пуст.
Значительные пробелы (отступы, пустые места) между заголовком и основным текстом лектио в уроке "Об Услугах Bskol" первого курса. Причина возникновения и способ исправления неизвестны. Не известно также, возникает ли данная проблема на других лектио.
Форматирование в режиме HTML является основным для нас. Однако клавиша спрятана в дополнительных возможностях, что заставляет делать два клика каждый раз. Более того, если HTML не выбран, то Moodle автоматически редактирует текст, добавляя дополнительные параграфы и разрывы страниц.
Ошибки шкалы прогресса в Учебке

Автосвязывание

обеспечить работу автосвязывания терминов словаря (Глоссария) с текстами лектико. Автосвязывание терминов словаря с текстами лектио не работает. В настройках словаря и терминов функция автосвязывания включена.
автосвязывания разделов курса с их названиями в текстах лектико необходимо убрать (снимок приложен).

Безопасность

Авторизация осуществляется федеративной службой, которая передаёт Учебке два типа емейлов -- один персональный и другой -- корпоративный. В данный момент, любой привелегированный пользователь курса (например, учитель или управляющий курса) имеет доступ к персональным емейлам. Проблема заключается в том, что учителями теоретически может быть большое количество участников проекта. Для обеспечения анонимности и неразглашения персональных данных учащихся, в профилях предлагается не показывать персональных емейлов вообще или, потенциально, показывать корпоративные емейлы.
Для разметки текста на Moodle используется HTML. В использовании JavaScript пока нет нужды, имеет смысл запретить его использования на учебных страницах, в целях безопасности.
Ученики на Брацка Учебка, в процессе прохождения обучения, используют только публикация простого не форматированного текста. Ввод форматированного текста должен быть запрещен. Запретить загрузку файлов учениками на курсе. Если в будущих курсах понадобиться использование учениками HTML разметки в тексте, нужно применить экранирование, для невозможности интерпретации JavaScript.
Разработать план аутентификации, который делает невозможным ввод стандартных логинов и паролей (admin / admin; admin / apple; admin / 1234…) не федеральных пользователей. Возможно с использовать плагинов.
Обеспечить недопущение идентификации при помощи не валидных данных.
Применять этапы подтверждения при удалении большого объема данных.

Содержимое

Тексты отзывов на втором и третьем курсе должны быть приведены в соответствие с текстами на первом курсе.
Оставить только два эссе "придумайте вопрос" на третьем курсе. Изначально, эти эссе были сделаны в качестве "заглушек", а затем о них забыли.

Роли

Роль "Студент" переименовать в "Ученик".
Роль "Преподаватель" переименовать в "Дидаскал".

Инциденты

Случаи нештатной работы, которые надо либо разрешить, либо доработать до требований:

При записи на курсы автоматом установка обнаружила следующую проблему -- система не отмечала окончание предыдущего курса. Проблема была решена установкой cron'а.

*/5 * * * * /usr/bin/php7.2  /var/www/html/campus.cbr/admin/cli/cron.php
*/5 * * * * /usr/bin/php7.2 /var/www/html/ucebka.bskol.com/admin/cli/cron.php

Cron запускается каждые 5 минут

Ошибка записи

На курсе Вводка ученик сообщил об ошибке записи в базу данных при обрабатывания кнопки "Отправить".

Незащищённое соединение

На курсе Выбор профессии по завершению первой четверти при открытии тестового задания в тексте ссылка bskol.com при нажатии для перехода выбивает "Подключение не защищено".[[2]]

Обновление версий

Наталья обновила версию Moodle на Учебке, из-за чего слетела автоматическая запись на следующий курс. Ученики пожаловались и я запись восстановил. Инцидент явился следствием отсутствия документации и, в частности, инструкции по обновлению. В идеале, обновление надо вначале проводить на будущей "экспериментальной" приладе, проверять по списку те функции, которые мы используем, а только затем обновлять основную копию.