====== Требования к созданию Pull-request по курсовой работой ====== Для допуска к защите курсовой работы необходимо сделать **__корректный__** Pull Request в репозиторий своей группы до установленного дедлайна: [[courses:programming:structure]] На пересдачах (дополенительная сессия и комиссия) крайний срок создания pull-request'а может отличаться. **Внимательно следите за объявлениями** в студенческом чате Pull-request ([[courses:git_rules|помимо обычных требований]]) должен содержать: * **Инструкцию** в формате markdown по сборке и запуску курсовой работы. Она должна включать полный список команд/шагов для этого и перечень зависимостей, которые требуется установить с инструкциями по их установке (или ссылки на официальные инструкции этих зависимостей). * **Полноценный отчёт по курсовой работе** ([[report]]) * В отчёте должны быть **примеры запуска курсовой работы**. Должно быть не менее **трех примеров** запуска приложения с разными входными данными. * **Изображения** (__если курсовая предполагает работу с изображениями__), для которых приведены примеры запусков, в количестве **не менее трёх** * В отчёте должны быть **примеры обработки ошибок** курсовой работой. Примеры должны показывать, какое поведение в случае обработок ошибок является нормальным для вашей программы. При этом //segmentation fault (core dumped)// или просто завершение с ненулевым кодом -- некорректная обработка ошибок. Например, пользователь указал неверный путь к файлу, а ваша программа завершается с сообщением "Путь к файлу указан неверно" - это является п__римером корректной обработки ошибки__. Для создания pull-request’а курсовая работа __должна пройти предварительную автоматическую проверку__ на moodle: * [[https://e.moevm.pro/course/section.php?id=1007|Предварительная автоматическая проверка для осеннего семестра]] * [[https://e.moevm.pro|Предварительная проверка для весеннего семестра (скоро будет)]] Для групп ТОП-ИТ могут предъявляться повышенные требования к курсовой работе, в том числе и в предварительной автоматической проверке Предварительная проверка **не гарантирует __полной__ работоспособности и корректности курсовой работы** Курсовая работа весеннего семестра должна содержать справку (help), доступную в графическом интерфейсе или в консоли в зависимости от реализации. Для CLI программ запуск программы без аргументов или с неправильными аргументами должен приводить к автоматическому отображению справки. После указанного срока **__не допускается изменение содержимого pull-request’а__**, даже “косметических”/небольших изменений. Если пренебречь этим, то __высок риск остаться без допуска к защите__ Pull Request должен быть сделан в указанный выше срок и содержать описанные выше шаги. Нарушение этих правил может привести к **__невозможности__** защиты курсовой.