Publish team projects. Improve project checkpoint and task description.
This commit is contained in:
@@ -2,52 +2,41 @@
|
||||
|
||||
- **Сдать материалы:** до 03.11.2026, 23:59.
|
||||
- **Ветка:** `nis/checkpoint-1`.
|
||||
- **Файл точки:** `nis/checkpoints/01.md`.
|
||||
|
||||
Команда уточняет обязательный результат назначенного задания и проверяет, что выбранный технический путь реалистичен в доступном окружении. Полный сквозной эксперимент на этом этапе не требуется.
|
||||
К первой точке команда описывает, что и как будет делать, и проверяет основные технические предпосылки проекта. Сквозной сценарий от входных данных до обработанных измерений потребуется ко [второй точке](02-working-result.md).
|
||||
|
||||
## Требуемый результат
|
||||
## Что сдать
|
||||
|
||||
В `nis/project.md` нужно зафиксировать:
|
||||
Подготовьте три файла; по ссылкам доступны шаблоны:
|
||||
|
||||
- состав реализации и поддерживаемые сценарии;
|
||||
- допустимые упрощения;
|
||||
- способы проверки завершённости обязательной работы;
|
||||
- выбранный технический путь.
|
||||
- [nis/project.md](../project-repository-template/nis/project.md) — ожидаемые результаты и способы их проверки, сценарии и упрощения;
|
||||
- [nis/experiment-plan.md](../project-repository-template/nis/experiment-plan.md) — план сравнения и обработки результатов;
|
||||
- [nis/checkpoints/01.md](../project-repository-template/nis/checkpoints/01.md) — итоги технических проверок, команды запуска, ссылки на код и результаты, открытые риски и вклад каждого участника.
|
||||
|
||||
Технические предпосылки проверяются с учётом выбранного пути:
|
||||
Откройте PR/MR из ветки `nis/checkpoint-1` в `main` по [правилам сдачи](../project-repository.md#сдача-через-prmr).
|
||||
|
||||
- для авторского артефакта — доступность кода и данных, сборка и минимальный запуск;
|
||||
- для самостоятельной реализации — достаточность описания метода, минимальный прототип и способ проверки корректности;
|
||||
- для симулятора — допущения, доступный эталон и способ проверки адекватности.
|
||||
## Описание проекта
|
||||
|
||||
Команда фиксирует фактически доступные ресурсы, проверяет их достаточность и измеримость показателей, прикладывает краткую инструкцию и воспроизводимые свидетельства выполненных проверок.
|
||||
В `nis/project.md` опишите ожидаемые результаты назначенного задания: что вы реализуете, какие проверки и эксперименты проведёте и какие материалы с результатами и их разбором подготовите. Для каждого пункта укажите, как проверить его выполнение. Ориентируйтесь на раздел «Обязательный результат» в карточке задания.
|
||||
|
||||
В `nis/experiment-plan.md` описываются baseline, данные или нагрузки, конфигурации, метрики, параметры, серии, повторы, проверка корректности и способ обработки и анализа результатов.
|
||||
Укажите [технический путь](../project.md#технический-путь-проекта); если карточка предлагает несколько вариантов, выберите один. Опишите упрощения и их влияние на результаты. Существенное изменение обязательного объёма нужно согласовать с преподавателем и отразить в обновлённой карточке задания.
|
||||
|
||||
Если добросовестная проверка выявила ошибочную предпосылку проектного задания, команда прикладывает диагностику и проверяемые свидетельства. Документированная ошибка задания не снижает статус точки. Преподаватель уточняет задание или, если сопоставимое уточнение невозможно, назначает другое свободное задание и письменно корректирует сроки и объём.
|
||||
## Технические проверки
|
||||
|
||||
## Структура `nis/checkpoints/01.md`
|
||||
Объём проверок зависит от пути проекта:
|
||||
|
||||
```markdown
|
||||
# Контрольная точка 1
|
||||
- **Авторский артефакт:** подготовьте код и данные, соберите используемые компоненты и запустите небольшой пример, связанный с заданием.
|
||||
- **Самостоятельная реализация:** проверьте, хватает ли описания метода, и реализуйте минимальный прототип ключевой операции. Покажите его работу на простом входе с известным ожидаемым результатом.
|
||||
- **Симулятор, в том числе написанный самостоятельно:** опишите допущения и выберите эталон — аналитический расчёт, опубликованные данные или доступную реализацию. Подготовьте простой случай для сравнения и получите эталонный результат. Если эталоном служит авторская программа, подготовьте её к работе и запустите на этом случае. Работающий прототип собственного симулятора и его сравнение с эталоном потребуются ко второй точке.
|
||||
|
||||
## Краткий результат
|
||||
Укажите доступные ресурсы и оцените, хватает ли их для запланированной работы. Для основных метрик проверьте доступность нужных данных: подойдёт пробный замер, пример журнала с нужными полями или расчёт по доступным данным. Рядом с описанием каждой проверки укажите команду запуска или ссылку на инструкцию, ожидаемый и полученный результат и ссылки на материалы.
|
||||
|
||||
## Проверенные технические предпосылки
|
||||
## План эксперимента
|
||||
|
||||
## Фактические ресурсы и измеримость показателей
|
||||
К сдаче выберите baseline, данные или нагрузки и начальные конфигурации. Укажите, какие параметры будете менять и в каких пределах, какие серии и повторы проведёте. Для каждой метрики задайте определение, единицы и способ сбора; опишите проверку корректности и обработку результатов.
|
||||
|
||||
## Инструкция и воспроизводимые свидетельства
|
||||
План должен позволять начать эксперименты. Масштаб нагрузки и диапазоны параметров можно уточнить после пробных запусков: отметьте такие решения и укажите, как и когда их примете. Готовая реализация baseline, полная серия измерений и итоговые выводы к первой точке не требуются.
|
||||
|
||||
## Ссылки на детализацию и план эксперимента
|
||||
Если проверка выявила ошибку в предпосылках задания, опишите проблему и приложите команды и результаты, которые её подтверждают. Документированная ошибка задания не снижает статус точки. Преподаватель уточнит задание или назначит другое свободное задание, если подходящего уточнения нет, и письменно скорректирует сроки и объём.
|
||||
|
||||
- [Детализация проекта](../project.md)
|
||||
- [План эксперимента](../experiment-plan.md)
|
||||
|
||||
## Открытые риски и следующие действия
|
||||
|
||||
## Ответственность участников
|
||||
```
|
||||
|
||||
Общие правила сдачи и карточка ответственности приведены на [странице контрольных точек](README.md).
|
||||
Общие [правила контрольных точек](README.md) описывают статусы, действия при блокировке и запись о работе каждого участника.
|
||||
|
||||
@@ -4,21 +4,21 @@
|
||||
- **Ветка:** `nis/checkpoint-2`.
|
||||
- **Файл точки:** `nis/checkpoints/02.md`.
|
||||
|
||||
Команда показывает один содержательный сквозной сценарий: входные данные проходят через работающий центральный механизм, после чего собираются метрики и получается обработанный результат. Масштаб может быть небольшим.
|
||||
Команда показывает один работающий сценарий из задания: подаёт входные данные, запускает реализацию исследуемого механизма, собирает измерения и обрабатывает их. Например, для проекта о восстановлении после сбоя — запускает обработку данных, вызывает сбой, проверяет результат после восстановления и измеряет время восстановления. Масштаб может быть небольшим.
|
||||
|
||||
## Требуемый результат
|
||||
|
||||
Материалы включают:
|
||||
|
||||
- инструкцию запуска и использованную конфигурацию;
|
||||
- короткую запись демонстрации;
|
||||
- пример исходных измерений и результат их обработки;
|
||||
- свидетельства проверки корректности;
|
||||
- для модели — проверку адекватности на доступном эталоне;
|
||||
- короткую запись демонстрации запуска и полученного результата;
|
||||
- пример исходных измерений и результат их обработки, например журнал запусков и таблицу времени выполнения;
|
||||
- выполненные проверки корректности: что ожидалось, что получено и где посмотреть результат проверки;
|
||||
- для симулятора или модели — сравнение с выбранным эталоном на простом случае и объяснение обнаруженных расхождений;
|
||||
- действующие упрощения и ещё не реализованные обязательные части.
|
||||
|
||||
К этой точке достаточно одного работающего варианта. Baseline, полная экспериментальная серия и устойчивые выводы пока не требуются.
|
||||
К этой точке достаточно одного работающего варианта исследуемого метода. Реализация baseline, сравнение с ним, полная экспериментальная серия и итоговые выводы пока не требуются.
|
||||
|
||||
Результат и ссылки оформляются в `nis/checkpoints/02.md`. Файл содержит краткий итог, команды запуска, конфигурацию, ссылки на демонстрацию, исходные и обработанные данные, проверку корректности, ограничения, риски и карточки ответственности участников. Можно начать с [шаблона файла](../project-repository-template/nis/checkpoints/02.md).
|
||||
Заполните [nis/checkpoints/02.md](../project-repository-template/nis/checkpoints/02.md): краткий итог, ссылки на перечисленные материалы, риски, следующие шаги и вклад участников. Добавьте команды сквозного запуска в `README.md` репозитория.
|
||||
|
||||
Общие правила сдачи и статусы приведены на [странице контрольных точек](README.md).
|
||||
|
||||
@@ -11,15 +11,15 @@
|
||||
Материалы включают:
|
||||
|
||||
- хотя бы одно содержательное сравнение основного метода с baseline;
|
||||
- сопоставимые входы и конфигурации;
|
||||
- одинаковые входы или одинаково сформированные выборки; конфигурации вариантов и объяснение различий между ними;
|
||||
- исходные измерения и обработанную таблицу или график;
|
||||
- необходимые повторы: для недетерминированных измерений не менее трёх, если задание явно не требует большего числа;
|
||||
- повторы для каждого варианта и набора параметров по [общим правилам проекта](../project.md#что-требуется-от-проекта);
|
||||
- предварительную интерпретацию и сопоставление с результатами статьи;
|
||||
- разбор расхождений, альтернативных объяснений и ограничений;
|
||||
- оставшуюся обязательную работу, сроки и ответственных;
|
||||
- отдельное описание возможного самостоятельного продолжения.
|
||||
- возможное самостоятельное продолжение, если планируете его; оно остаётся необязательным.
|
||||
|
||||
Сопоставление со статьёй учитывает различия стендов и может проверять тенденции и механизм. Совпадение абсолютных значений не требуется. Корректный отрицательный результат допускается на общих основаниях. Основное воспроизведение завершается к итоговой сдаче **19 марта 2027 года, 23:59**.
|
||||
Объясните, что показывает сравнение и насколько результат меняется между повторами. Сопоставьте его с конкретным результатом статьи с учётом различий оборудования, данных и настроек. Например, можно проверить, сохраняется ли преимущество метода при росте нагрузки; совпадение абсолютных значений не требуется. Отделите подтверждённые объяснения расхождений от предположений, которые ещё нужно проверить. Корректный отрицательный результат допускается на общих основаниях. Основное воспроизведение завершается к итоговой сдаче **19 марта 2027 года, 23:59**.
|
||||
|
||||
Результат и ссылки оформляются в `nis/checkpoints/03.md`. Можно начать с [шаблона файла](../project-repository-template/nis/checkpoints/03.md).
|
||||
|
||||
|
||||
@@ -23,7 +23,9 @@
|
||||
Виды работы (необязательно):
|
||||
```
|
||||
|
||||
Запись кратко фиксирует результаты без учёта затраченного времени. В необязательном поле можно указать постановку, методику, программную реализацию, данные, эксперимент, анализ, проверку, визуализацию или работу над отчётом. Название вида работы на оценку не влияет.
|
||||
Повторите этот блок для каждого участника. В ответственности укажите конкретную задачу, например «реализовать проверку результатов после перезапуска». В результате опишите, что сделано за этот этап, и дайте ссылки на код, тесты, данные или текст. Если существенных изменений и блокировок не было, так и напишите.
|
||||
|
||||
Учёт затраченного времени не нужен. В необязательном поле можно указать постановку, методику, программную реализацию, данные, эксперимент, анализ, проверку, визуализацию или работу над отчётом. Название вида работы на оценку не влияет.
|
||||
|
||||
## Статус точки
|
||||
|
||||
|
||||
Reference in New Issue
Block a user