4363
Комментарий:
|
4429
|
Удаления помечены так. | Добавления помечены так. |
Строка 7: | Строка 7: |
* Как только Вы '''начинаете''' работу над каким-либо модулем, Вы указываете своё имя в поле Maintainer и дату начала в поле Start Date. * '''По завершении''' работы над модулем (когда модуль готов) ментейнер указывает End Date. * На страницах со списками модулей также присутствует поле Should be done, в котором указана '''желаемая дата окончания работы над модулем''' (расчитывается как дата начала плюс количество дней на написание модуля). |
* Как только Вы '''начинаете''' работу над каким-либо модулем, Вы указываете своё имя в поле Maintainer и дату начала в поле Start Date. * '''По завершении''' работы над модулем (когда модуль готов) ментейнер указывает End Date. * На страницах со списками модулей также присутствует поле Should be done, в котором указана '''желаемая дата окончания работы над модулем''' (расчитывается как дата начала плюс количество дней на написание модуля). * Материалы в первую очередь нужны самые простые: технической документации много, и люди, которым она нужна, сами в состоянии её найти * См. [[../Materials|дисциплину оформления материала]] |
Строка 12: | Строка 14: |
Строка 16: | Строка 17: |
* Лекционный минимум, дополненный ссылками на материалы * Материалы полностью покрывают тематику лекционного минимума * Формальный критерий: каждому пункту лекционного минимума соответствует не менее одной ссылки на материал * Если несколько пунктов обеспечиваются одним и тем же материалом, на него надо ссылаться ''в каждом из пунктов'' ''Here goes piece of crap'' |
|
Строка 22: | Строка 18: |
* Материалы должны быть вычитаны на предмет пригодности ПСПО * Материалы должны закрывать весь лекционный минимум * Документы должны иметь паспорт * Дописывание скриншотов с комментариями * Проверены на лицензионную чистоту * Модуль проверен ГК == Рекомендации по процессу формирования модуля == ''Here goes piece of crap'' * Уровень подачи материалов --- на пальцах. Технических текстов существует много, задача --- написать (или найти) материалы, которые просто и доходчиво объясняют содержание модуля * Материалы должны быть вычитаны на предмет пригодности ПСПО * Для всех используемых материалов необходимо формировать паспорт документа. Полиси по формированию будет [[../Materials|здесь]] как только появится обвеска для их создания |
* Готовность лекционных материалов не ниже 70% * Материал, имеющий значимое различие с ПСПО, или требующий комментария, должен быть прокомментирован в итоговом тексте модуля или в паспорте самого материала === Оформление "итогового текста" === * Итоговый текст -- это лекционный минимум, дополненный ссылками на материалы * Материалы полностью покрывают тематику лекционного минимума * Формальный критерий: каждому пункту лекционного минимума соответствует не менее одной ссылки на материал * Если несколько пунктов обеспечиваются одним и тем же материалом, на него надо ссылаться ''в каждом из пунктов'' * Если используемый материал требует комментариев (например, на предмет лёгкой устарелости, несоответствия ПСПО или особенностей авторской позиции), их желательно оставлять в конце итогового текста * В конце итогового текста находятся, если нужны, ссылки на материалы, не следующие прямо из контекста лекционного минимума, но рекомендуемые к просмотру ("SEE ALSO") |
Строка 39: | Строка 31: |
|| 0%---20% || Сбор материалоов (накидывание ссылок), закрывающих полностью лекционный минимум || || 20%---40% || Решение проблем с лицензией || || 40%---60% || Текст склейки || || 60%---80% || Вычитка и скриншоты, соответствие ПСПО, постпроцессинг || || 80%---90% || Паспорт || |
|| 0%---40% || Сбор материалов (накидывание в любом формате ссылок), закрывающих полностью лекционный минимум || || 40%---70% || Решение проблем с лицензией и втягивание материалов|| || 70%---90% || Итоговый текст (включая комментарии и "see also")|| |
Полиси по оформлению модулей
Начало
У каждого модуля внизу есть небольшая таблица, в котором находится вся его метаинформация. На основе неё формируются таблицы для курсов и полный список модулей. В этой таблице есть поля Maintainer, Start Date и End Date (если они отсутствуют, то их можно дописать в конец в указанном порядке).
Как только Вы начинаете работу над каким-либо модулем, Вы указываете своё имя в поле Maintainer и дату начала в поле Start Date.
По завершении работы над модулем (когда модуль готов) ментейнер указывает End Date.
На страницах со списками модулей также присутствует поле Should be done, в котором указана желаемая дата окончания работы над модулем (расчитывается как дата начала плюс количество дней на написание модуля).
- Материалы в первую очередь нужны самые простые: технической документации много, и люди, которым она нужна, сами в состоянии её найти
Критерии готовности модуля
- Текст модуля:
- Имеется лекционный минимум
- Имеется "Итоговый текст":
- Материалы модуля:
- Готовность лекционных материалов не ниже 70%
- Материал, имеющий значимое различие с ПСПО, или требующий комментария, должен быть прокомментирован в итоговом тексте модуля или в паспорте самого материала
Оформление "итогового текста"
- Итоговый текст -- это лекционный минимум, дополненный ссылками на материалы
- Материалы полностью покрывают тематику лекционного минимума
- Формальный критерий: каждому пункту лекционного минимума соответствует не менее одной ссылки на материал
Если несколько пунктов обеспечиваются одним и тем же материалом, на него надо ссылаться в каждом из пунктов
- Если используемый материал требует комментариев (например, на предмет лёгкой устарелости, несоответствия ПСПО или особенностей авторской позиции), их желательно оставлять в конце итогового текста
- В конце итогового текста находятся, если нужны, ссылки на материалы, не следующие прямо из контекста лекционного минимума, но рекомендуемые к просмотру ("SEE ALSO")
Прогресс
Приблизительный процент готовности для различных этапов формирования модуля:
0%---40% |
Сбор материалов (накидывание в любом формате ссылок), закрывающих полностью лекционный минимум |
40%---70% |
Решение проблем с лицензией и втягивание материалов |
70%---90% |
Итоговый текст (включая комментарии и "see also") |
90%---100% |
Вычитка ГК |