Difference between revisions of "Week 9"

From Research management course
Jump to: navigation, search
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
{{#seo:
 +
|title=Course My first scientific paper: Week 9
 +
|titlemode=replace
 +
|keywords=My first scientific paper
 +
|description=Course My first scientific paper: The goal of the week is to check that the latest version of the article has been uploaded and meets the requirements.
 +
}}
 +
 
== W: Review  ==
 
== W: Review  ==
  
===Автор:===
+
===Автор===
# проверяет, что последняя версия статьи загружена и  
+
# Проверяет, что последняя версия статьи загружена и  
 
# она соответствует требованиям [[Week 8|прошлой недели]].
 
# она соответствует требованиям [[Week 8|прошлой недели]].
  
===Рецензент:===
+
Цель этой недели: написать рецензию на работу.
# Ставит свою фамилию [http://bit.ly/m1p_2021 в таблице на странице группы].
+
 
 +
Вызов: найти в рецензируемой работе такую ошибку или предложить такое решение, которые ее разрушат.
 +
 
 +
===Рецензент===
 +
# Выбирает работу для рецензценизрования и указывает [https://docs.google.com/spreadsheets/d/1tdfQ20-OX_-TRcxPr_IQ3rNrOTZwSfmUNoRS9tB2DUI/edit?usp=sharing в таблице].
 +
# Ставит свою фамилию [https://github.com/intsystems/m1p/ в таблице на странице группы].
 
# Загружает рецензию в свою папку doc/, см.  
 
# Загружает рецензию в свою папку doc/, см.  
 
#* [http://www.machinelearning.ru/wiki/images/d/d5/Surname2018Title_Review.rtf шаблон рецензии] и
 
#* [http://www.machinelearning.ru/wiki/images/d/d5/Surname2018Title_Review.rtf шаблон рецензии] и
#* [https://mlalgorithms.svn.sourceforge.net/svnroot/mlalgorithms/Example2012Reviews/ примеры рецензий].  
+
#* [https://sourceforge.net/p/mlalgorithms/code/HEAD/tree/Examples/ArticleReviews/ примеры рецензий].  
 
# Рецензия не обязательно содержит описание рецензируемой работы, но содержит  
 
# Рецензия не обязательно содержит описание рецензируемой работы, но содержит  
 
#* мнение рецензента о новизне, актуальности и обоснованности работы, а также  
 
#* мнение рецензента о новизне, актуальности и обоснованности работы, а также  
 
#* список ошибок, недочетов и замечаний, призванных улучшить качество статьи.
 
#* список ошибок, недочетов и замечаний, призванных улучшить качество статьи.
 +
#* комментарии к коду (в виде комментариев исходников в репозитории проверяемой работы)
  
 
Рецензент проверяет следующие критерии
 
Рецензент проверяет следующие критерии
Line 38: Line 51:
 
===Соглашение о комментировании===
 
===Соглашение о комментировании===
 
Приняты следующие комментарии, добавляемые в код при его проверке:
 
Приняты следующие комментарии, добавляемые в код при его проверке:
* % FIXIT – желательно изменить код (улучшить структуру кода или устранить ошибку),  
+
* % FIXIT (или # FIXIT, в зависимости от языка исходного кода) – желательно изменить код (улучшить структуру кода или устранить ошибку),  
 
* % FIXED – устраненные ошибки или улучшенный код,  
 
* % FIXED – устраненные ошибки или улучшенный код,  
 
* % NOTE – комментарий для обмена мнениями,
 
* % NOTE – комментарий для обмена мнениями,
Line 44: Line 57:
  
 
==Resources==
 
==Resources==
* [Video for week 9].
+
* [http://www.youtube.com/watch?v=_7PixrLl_Mc Video for week 9].
* [Slides for week 9].
+
* [http://www.machinelearning.ru/wiki/images/5/53/M1p_lect9.pdf Slides for week 9].
 
* Шаблон рецензии [http://www.machinelearning.ru/wiki/images/d/d5/Surname2018Title_Review.rtf Surname2018Title_Review.rtf].
 
* Шаблон рецензии [http://www.machinelearning.ru/wiki/images/d/d5/Surname2018Title_Review.rtf Surname2018Title_Review.rtf].
* Примеры [https://mlalgorithms.svn.sourceforge.net/svnroot/mlalgorithms/Example2012Reviews/ рецензий], которые обсуждались на лекции.
+
* Примеры рецензий на
 +
** [https://sourceforge.net/p/mlalgorithms/code/HEAD/tree/Examples/ArticleReviews/ научные статьи],
 +
** [https://sourceforge.net/p/mlalgorithms/code/HEAD/tree/Examples/ThesisReviews/ квалификационные работы].

Latest revision as of 16:57, 19 February 2024

W: Review

Автор

  1. Проверяет, что последняя версия статьи загружена и
  2. она соответствует требованиям прошлой недели.

Цель этой недели: написать рецензию на работу.

Вызов: найти в рецензируемой работе такую ошибку или предложить такое решение, которые ее разрушат.

Рецензент

  1. Выбирает работу для рецензценизрования и указывает в таблице.
  2. Ставит свою фамилию в таблице на странице группы.
  3. Загружает рецензию в свою папку doc/, см.
  4. Рецензия не обязательно содержит описание рецензируемой работы, но содержит
    • мнение рецензента о новизне, актуальности и обоснованности работы, а также
    • список ошибок, недочетов и замечаний, призванных улучшить качество статьи.
    • комментарии к коду (в виде комментариев исходников в репозитории проверяемой работы)

Рецензент проверяет следующие критерии

  1. Ясность основного сообщения, наличие единого объекта исследования
  2. Точность терминов, связность изложения
  3. Стандартность, непротиворечивость и ясность обозначений
  4. Соответствие цели и содержания эксперимента поставленной задаче
  5. Полнота анализа ошибки
  6. Повторяемость эксперимента:
    1. основной алгоритм восстанавливается из математического описания или из псевдокода без помощи автора,
    2. код читается легко, есть его описания, основной модуль легко найти, он запускает базовый вариант эксперимента,
    3. в статье есть ссылка на код и на выборку.

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

При рецензировании исходного текста и кода

Рецензент

  • в тексте статьи ставит пометки \footnote{Замечание к статье},
  • в файлах-исходниках ставит пометки % FIXIT Замечание к коду.

Автор

  • в статье вносит требуемые исправления и к пометкам \footnote{Замечание к статье – Ответы на замечания} добавляет ответы рецензенту,
  • в файлах-исходниках вносит требуемые исправления и исправляет пометки % FIXIT на %FIXED, добавляя ответы рецензенту.

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

Соглашение о комментировании

Приняты следующие комментарии, добавляемые в код при его проверке:

  •  % FIXIT (или # FIXIT, в зависимости от языка исходного кода) – желательно изменить код (улучшить структуру кода или устранить ошибку),
  •  % FIXED – устраненные ошибки или улучшенный код,
  •  % NOTE – комментарий для обмена мнениями,
  •  % TODO – желательно выполнить работу.

Resources