Написание отчётов и статей (рекомендации)

Материал из MachineLearning.

(Различия между версиями)
Перейти к: навигация, поиск
(уточнение, дополнение)
(Простота и постоянство обозначений)
 
(33 промежуточные версии не показаны)
Строка 17: Строка 17:
К отчетам, курсовым и выпускным работам изложенные там соображения тоже относятся в полной мере.
К отчетам, курсовым и выпускным работам изложенные там соображения тоже относятся в полной мере.
 +
== С чего начать ==
 +
 +
Допустим, вы решили задачу — построили модель, доказали теорему, сделали вычислительный эксперимент, получили результаты.
 +
С чего начать писать отчёт, как преодолеть барьер вхождения?
 +
* Сформулируйте и запишите цели вашего исследования. Вам наверняка придётся использовать специальные термины, которые Ваш приятель-однокурсник не знает. Допустим, Вы объясняете ему Вашу работу, пока идёте вместе от университета до ближайшего транспорта. Бумаги и ручки нет, доски нет, презентации нет, можно только говорить. Объясните ключевые понятия, расскажите, откуда взялась задача, и в чём состояла проблема. Вот Вы и написали введение.
 +
* Запишите структурный план всей статьи, со всеми разделам и подразделами.
 +
* Начните писать тот раздел, который Вам кажется наиболее простым и ясным. Обычно это раздел понятий и обозначений.
 +
* Вот Вы и разогнались. Далее дело пойдёт само. Дописывайте разделы в том порядке, к которому у Вас лежит душа. Научная статья — это не детектив, её не обязательно писать подряд.
 +
* Каждый раз, когда дело застопоривается, консультируйтесь с научным руководителем.
 +
== Типичная структура научной статьи ==
== Типичная структура научной статьи ==
 +
 +
Чтобы научиться писать научные статьи, надо понять, как люди их читают.
 +
Оказывается, большинство учёных читают аннотацию, заключение и (прямо как дети) смотрят картинки, пытаясь быстро сделать какие-то выводы из графиков и подписей под ними.
 +
Только если статья кажется стоящей, чтобы потратить на неё время, её начинают читать.
 +
Но большинство всё равно не читают дальше введения.
 +
* [http://medach.pro/media/guides/article-guide Как (серьезно) читать научные статьи]
 +
 +
Отсюда важные практические выводы:
 +
* в аннотации и заключении надо написать самое главное, что вы хотите донести до максимально широкой аудитории;
 +
* в статье обязательно должен быть график, максимально наглядно показывающий самый главный полученный вами результат;
 +
* каждый график вместе с подрисуночной подписью должен быть наглядным и самодостаточным сообщением научного результата;
 +
* в ходе исследования надо постоянно задумываться о том, как вы будете презентовать каждый ваш результат.
=== Аннотация ===
=== Аннотация ===
Строка 70: Строка 92:
Во-первых, сделать статью самодостаточной — дать необходимый минимум информации тем читателям, которые не очень хорошо ориентируются в теме, но желают поближе познакомиться именно с данной работой.
Во-первых, сделать статью самодостаточной — дать необходимый минимум информации тем читателям, которые не очень хорошо ориентируются в теме, но желают поближе познакомиться именно с данной работой.
Во-вторых, облегчить сопоставление полученных автором результатов с ранее известными.
Во-вторых, облегчить сопоставление полученных автором результатов с ранее известными.
 +
 +
Как понять, какие обозначения надо вводить, и какие известные результаты упоминать, особенно, если это первая в жизни научная статья?
 +
 +
'''Критерий:''' если это бакалаврская диссертация, то текст должен быть написан так, чтобы любой студент, учившийся на другой кафедре, смог понять всё.
=== Новые подходы и результаты ===
=== Новые подходы и результаты ===
Строка 129: Строка 155:
* ссылаться только на очень старые работы;
* ссылаться только на очень старые работы;
* ссылаться на работы, которых автор ни разу не видел;
* ссылаться на работы, которых автор ни разу не видел;
-
* вообще ни на что не ссылаться.
+
* вообще ни на что не ссылаться.
 +
 
 +
=== Что совсем не принято ===
 +
В англоязычных квалификационных работах, где-то в начале, иногда встречаются посвящения типа «моим дорогим родителям и сестрёнке», «дедушке с бабушкой», «любимой жене, попугаю, двум собакам и трём котам за то, что не слишком мешали», ну, и так далее... В нашей национальной традиции за такие фортели подвергают остракизму. Вот вырастете большим, будете писать большую толстую книгу, и там себе позволяйте что угодно или что редактор разрешит.
== Десять принципов ясного изложения ==
== Десять принципов ясного изложения ==
-
=== Не ходить «вокруг да около» ===
+
Чтобы научиться самому хорошо писать научные тексты, надо постоянно читать чужие научные тексты.
 +
При этом задумываться над такими вопросами:
 +
Всё ли мне действительно понятно?
 +
Если что-то не понятно, то почему — моих знаний не хватает или написано плохо?
 +
Если написано плохо, то что именно, и что должен был бы сделать автор, чтобы я его понял.
 +
При таком вдумчивом чтении Вы скоро выработаете свои приёмы ясного изложения.
 +
 
 +
=== Прямой путь — самый короткий ===
 +
 
 +
Всегда используйте минимальный набор средств (понятий, обозначений, пояснений), достаточный, чтобы Вас поняли.
 +
Не правда ли, красивые общие слова, но совершенно неконкретные...
 +
Как же воспользоваться этой рекомендацией на практике?
 +
Одна из возможных технологий такая:
 +
 
Подумайте, какую основную мысль Вы собираетесь донести до читателя. Не начинайте издалека, именно её сразу и напишите.
Подумайте, какую основную мысль Вы собираетесь донести до читателя. Не начинайте издалека, именно её сразу и напишите.
-
Теперь подумайте, почему Вас могут не понять.
+
Теперь подумайте, почему Вас могут не понять, если сходу прямо так и сказать.
-
Например, Вы не объяснили ключевое понятие или не дали важного определения. Именно его и напишите (разумеется, ''перед'' основной мыслью).
+
Ваш коллега, вместе с которым Вы делали эту работу, наверное, поймёт.
-
Вот так, от конца к началу, с постоянной заботой о том, что может не понять читатель, и составляется план будущей статьи.
+
А вот незнакомому читателю надо сперва объяснить все использованные Вами понятия, сформулировать проблему, объяснить, зачем её надо решать, и т.д.
-
Главное ничего лишнего!
+
Всё это придётся написать ''перед'' основной мыслью.
 +
 
 +
Главное — не «ходить вокруг да около» и не писать лишнего!
 +
Пишите только то, без чего основную мысль объяснить невозможно.
 +
 
 +
Этот принцип продумывания изложения относится как к статье в целом, так и к любым её частям, вплоть до отдельных предложений.
 +
Вот так, от конца к началу, с постоянной заботой о потенциальном читателе, и возникает структура будущей статьи.
 +
 
 +
Старайтесь дойти до раскрытия основной мысли кратчайшим путём.
 +
Как будет найден этот путь от конца к началу, от начала к концу или с середины — в конечном итоге не так уж важно, это дело вкуса.
'''Наблюдение.'''
'''Наблюдение.'''
-
Многие студенты по началу думают, что надо писать витиевато и наукообразно.
+
Многие студенты поначалу думают, что надо писать витиевато и наукообразно.
-
На самом деле это не придаёт тексту солидности, как раз наоборот — вызывает подозрение, что работа является «пустышкой».
+
На самом деле это не придаёт тексту солидности, как раз наоборот — вызывает подозрение, что работа является «пустышкой», формой без содержания.
-
Из таких текстов можно выбрасывать без ущерба для смысла целые абзацы, фразы, большие куски фраз.
+
Из таких текстов можно без ущерба для смысла выбрасывать целые абзацы, фразы, отдельные слова.
-
Задача в том, чтобы дойти до раскрытия основной мысли кратчайшим путём.
+
Чаще перечитывайте текст и проверяйте каждую фразу: можно ли её выкинуть?
 +
Является ли такой ход изложения кратчайшим?
 +
Тут полезно быть жадным, но только в том смысле, чтобы побольше выкинуть, а не побольше написать.
=== Время читателя — ценнейший ресурс ===
=== Время читателя — ценнейший ресурс ===
Строка 153: Строка 206:
«Казённым» стилем обычно пишутся законы, руководства и инструкции.
«Казённым» стилем обычно пишутся законы, руководства и инструкции.
В советские времена в таком стиле писали газеты (хочешь понять — читай между строк).
В советские времена в таком стиле писали газеты (хочешь понять — читай между строк).
-
Таким стилем все ещё пишут некоторые ученые…
+
Таким стилем все ещё пишут некоторые провинциальные ученые…
Но это неправильно.
Но это неправильно.
Автор должен стремиться экономить время читателей хотя бы потому, что он один, а читателей много.
Автор должен стремиться экономить время читателей хотя бы потому, что он один, а читателей много.
-
Сегодня никто не хочет тратить своё время на чтение между строк.
+
Сегодня никто не хочет тратить своё время на чтение между строк и выискивание крупиц смысла в пустых витиеватых фразах.
Время дороже денег.
Время дороже денег.
-
Если статью не удаётся понять быстро, она будет отложена навсегда.
+
Если статью не удаётся понять быстро, она будет отложена навсегда.
=== Краткость — сестра таланта ===
=== Краткость — сестра таланта ===
Строка 197: Строка 250:
=== Простота и постоянство обозначений ===
=== Простота и постоянство обозначений ===
Система обозначений должна быть проста (не перегружена) и не меняться по ходу изложения.
Система обозначений должна быть проста (не перегружена) и не меняться по ходу изложения.
 +
 +
'''Наблюдение.'''
 +
Трудно читать статью, в которой постоянно повторяются одни и те же сложные (состоящие из многих символов) агрегаты. Почему? Читатель тратит время и мыслительные усилия на постоянное сравнение того агрегата, который он видит сейчас, с теми, которые встречались на предыдущих старницах. То есть зашифровывать математический текст всегда проще, чем расшифровывать. Не обманывайте себя этой простотой и пожалейте своих читателей.
 +
 +
Отсюда вывод: если агрегат встречается более двух раз, возможно, для него стоит ввести вспомогательную букву и как-то назвать его словами. Человеку привычнее и приятнее запоминать и сравнивать имена, чем многоэтажные формулы.
'''Наблюдение.'''
'''Наблюдение.'''
Строка 202: Строка 260:
В английском алфавите достаточно букв, чтобы приписать им фиксированные роли.
В английском алфавите достаточно букв, чтобы приписать им фиксированные роли.
-
Например, если договорились, что <tex>x_i</tex> — <tex>i</tex>-й объект, то лучше не использовать букву <tex>x</tex> и индекс <tex>i</tex> для чего-либо, кроме объектов.
+
Например, если договорились, что <tex>x_i</tex> — это <tex>i</tex>-й объект, то лучше не использовать букву <tex>x</tex> и индекс <tex>i</tex> для чего-либо, кроме объектов.
Тогда читатель быстро привыкает к обозначениям основных понятий, и уже не будет отвлекаться на то, чтобы вернуться выше и разобраться, в данном случае <tex>i</tex> глобален (тот самый, что был использован при введении обозначений в самом начале), или он снова в десятый раз поменял смысл.
Тогда читатель быстро привыкает к обозначениям основных понятий, и уже не будет отвлекаться на то, чтобы вернуться выше и разобраться, в данном случае <tex>i</tex> глобален (тот самый, что был использован при введении обозначений в самом начале), или он снова в десятый раз поменял смысл.
Строка 208: Строка 266:
Лучший способ заставить человека потратить на изучение отчёта втрое больше времени — всё время менять обозначения, а индексы и аргументы функций вводить «ненадолго» и ниже произвольным образом менять их смысл.
Лучший способ заставить человека потратить на изучение отчёта втрое больше времени — всё время менять обозначения, а индексы и аргументы функций вводить «ненадолго» и ниже произвольным образом менять их смысл.
Тогда читатель будет тратить основное время на то, чтобы понять, что есть что, и легко пропустит десяток действительно серьёзных ляпов.
Тогда читатель будет тратить основное время на то, чтобы понять, что есть что, и легко пропустит десяток действительно серьёзных ляпов.
-
Автор должен быть готов к тому, что читатель расценит такой текст как оскорбление или попытку сознательного сокрытия истинного положения дел.
+
Автор должен быть готов к тому, что читатель расценит такой текст как оскорбление или попытку сознательного сокрытия истинного положения дел.
-
=== Неформальные объяснения и интерпретации ===
+
=== Баланс формального и неформального ===
Формальное изложение (гипотезы, определения, леммы, теоремы, следствия, замечания) должно перемежаться неформальными пояснениями, интерпретациями, замечаниями, примерами, апеллирующими к интуиции и здравому смыслу.
Формальное изложение (гипотезы, определения, леммы, теоремы, следствия, замечания) должно перемежаться неформальными пояснениями, интерпретациями, замечаниями, примерами, апеллирующими к интуиции и здравому смыслу.
Однако оформляться это должно так, чтобы читатель сразу понял:
Однако оформляться это должно так, чтобы читатель сразу понял:
Строка 226: Строка 284:
Основные идеи текста должны быть в целом понятны, если целиком пропускать доказательства.
Основные идеи текста должны быть в целом понятны, если целиком пропускать доказательства.
Если внутри доказательства спрятана важная идея, то её обсуждение стоит вынести за пределы доказательства.
Если внутри доказательства спрятана важная идея, то её обсуждение стоит вынести за пределы доказательства.
-
В&nbsp;таком случае лучше разбить доказательство на леммы.
+
В&nbsp;таком случае лучше разбить доказательство на леммы.
=== Структуризация ===
=== Структуризация ===
Строка 237: Строка 295:
'''Наблюдение.'''
'''Наблюдение.'''
В маргинальных исследованиях вопросы «зачем» и «почему так» либо не ставятся,
В маргинальных исследованиях вопросы «зачем» и «почему так» либо не ставятся,
-
либо на них даются невнятные (неконкретные, слишком философские) ответы.
+
либо на них даются невнятные (неконкретные, слишком философские) ответы.
 +
Это может означать, что автор считает себя умнее мирового научного сообщества или просто поленился изучить предыдущий опыт, и теперь изобретает велосипед.
 +
Такие работы, как правило, неадекватны и только засоряют мозг.
Каждый раздел, независимо от уровня и объема, строится по одному и тому же сценарию.
Каждый раздел, независимо от уровня и объема, строится по одному и тому же сценарию.
Строка 246: Строка 306:
'''Важный принцип:'''
'''Важный принцип:'''
-
изложение в целом должно быть понятным, если средние части во всех разделах целиком опустить.
+
изложение в целом должно быть понятным, если средние части во всех разделах целиком опустить.
-
=== Жёсткая последовательность ===
+
=== Логичная последовательность изложения ===
-
Каждая следующая фраза должна вытекать непосредственно из предыдущей.
+
Каждая следующая фраза должна логично вытекать непосредственно из предыдущей (или нескольких предыдущих).
-
Слишком жестко? Тогда хотя бы 95% фраз.
+
Слишком жёстко? Тогда хотя бы 95% фраз.
Следить за линейной логикой изложения на порядок менее утомительно, чем за перескоками с темы на тему.
Следить за линейной логикой изложения на порядок менее утомительно, чем за перескоками с темы на тему.
Резкая смена темы должна оформляться в явном виде как новый параграф, раздел, подраздел.
Резкая смена темы должна оформляться в явном виде как новый параграф, раздел, подраздел.
Любой термин или обозначение должны быть введены до первого использования, даже если они общеупотребительны.
Любой термин или обозначение должны быть введены до первого использования, даже если они общеупотребительны.
-
Это вроде бы очевидно, но по неопытности трудно уследить за каждой закорючкой.
+
Это вроде бы очевидно, но по неопытности трудно уследить за каждой закорючкой, особенно, когда текст многократно переделывается.
'''Наблюдение.'''
'''Наблюдение.'''
В&nbsp;учебниках и хороших книгах таких грубых ошибок не бывает — благодаря тому, что
В&nbsp;учебниках и хороших книгах таких грубых ошибок не бывает — благодаря тому, что
-
эти тексты десятки раз вычитываются авторами, рецензентами и редакторами.
+
эти тексты десятки раз вычитываются авторами, рецензентами и редакторами.
-
=== Глаголы ===
+
=== Точность передачи смысла ===
-
За точность смысла отвечают глаголы.
+
Это, наверное, самое сложное.
 +
От&nbsp;автора требуется хорошее владение как техническим, так и литературным языком.
 +
 
 +
'''Наблюдение:'''
 +
хорошо садиться писать статью, начитавшись хорошей специальной или художественной литературы.
 +
 
 +
От автора также требуется изрядная изобретательность.
 +
Автор имеет полную свободу выбора — какие понятия и определения ввести, чтобы дальнейшее изложение было максимально удобным и понятным.
 +
 
 +
'''Наблюдение:'''
 +
презентабельность основного результата может сильно зависеть от того, какими словами о нём рассказывают.
 +
Если суть результата не удаётся донести парой фраз, это, возможно, признак того, что стоило бы ввести несколько новых понятий.
 +
То&nbsp;есть придать нескольким хорошо известным русским словам новый, Ваш собственный, узко специальный, смысл.
 +
Разумеется, удачный выбор таких слов — это искусство.
 +
 
 +
В то же время, избегайте вводить новые термины, если в литературе известны их аналоги. Делайте это лишь в крайнем случае, не плодите термины без необходимости.
 +
 
 +
'''Наблюдение:'''
 +
в предложениях за точность смысла отвечают глаголы.
Тщательный подбор одного единственного глагола иногда способен заменить пару строк простанных комментариев.
Тщательный подбор одного единственного глагола иногда способен заменить пару строк простанных комментариев.
-
Старайтесь не употреблять слишком абстрактных глаголов
+
 
 +
Старайтесь не употреблять слишком абстрактных глаголов:
является, имеется, позволяет, поддерживает, применяется, и т.п.
является, имеется, позволяет, поддерживает, применяется, и т.п.
Это легкомысленная расточительность такого ценного ресурса, как глаголы.
Это легкомысленная расточительность такого ценного ресурса, как глаголы.
Ведь в каждой фразе глагол только один.
Ведь в каждой фразе глагол только один.
-
'''Наблюдение:''' «казенные» тексты напичканы абстрактными глаголами.
+
'''Наблюдение:''' «казенные» тексты напичканы абстрактными глаголами.
=== Семь раз прочти, один раз отправь ===
=== Семь раз прочти, один раз отправь ===
Строка 305: Строка 384:
Обычно в&nbsp;этот момент студент осознаёт, какие чувства у&nbsp;преподавателя вызывает его работа... и&nbsp;начинает стараться.
Обычно в&nbsp;этот момент студент осознаёт, какие чувства у&nbsp;преподавателя вызывает его работа... и&nbsp;начинает стараться.
-
== Дело техники ==
+
== Дело ТеХники ==
Для оформления научных статей, отчётов, квалификационных работ, учебных курсов, книг рекомендуется освоить систему компьютерной вёрстки [[LaTeX]].
Для оформления научных статей, отчётов, квалификационных работ, учебных курсов, книг рекомендуется освоить систему компьютерной вёрстки [[LaTeX]].
* [http://www.ccas.ru/voron/latex.html#miktex Памятка] по установке и использованию MiKTeX и WinEdt.
* [http://www.ccas.ru/voron/latex.html#miktex Памятка] по установке и использованию MiKTeX и WinEdt.
-
* [[Media:voron05latex.pdf|LaTeX в примерах (pdf)]] — сборник примеров, помогающий довольно быстро освоить LaTeX в объеме, достаточном для написания первой статьи.
+
* [[Media:voron05latex.pdf|LaTeX в примерах (pdf)]] — сборник примеров, помогающий довольно быстро освоить LaTeX в объеме, достаточном для написания первой статьи.
== Статья на английском ==
== Статья на английском ==
Строка 316: Строка 395:
** не переводите текст с русского на английский, а рассказывайте содержание вашей работы по-английски;
** не переводите текст с русского на английский, а рассказывайте содержание вашей работы по-английски;
** в каждой фразе придерживайтесь жёсткого порядка: подлежащее → сказуемое → дополнение;
** в каждой фразе придерживайтесь жёсткого порядка: подлежащее → сказуемое → дополнение;
 +
** не стройте слишком сложных и длинных предложений;
** используйте математические клише, которые даются в этих двух книгах;
** используйте математические клише, которые даются в этих двух книгах;
-
* Введение, где больше всего «человеческой речи», пишите в последнюю очередь. Начинать лучше с вводной части, где даются формальные определения. Тогда к моменту написания введения необходимая терминология и обороты речи уже будут «загружены в оперативную память».
+
* Введение, обзор и другие разделы, где больше всего «человеческой речи», пишите в последнюю очередь. Начинать проще всего с раздела определений и обозначений, затем переходить к формальным математическим результатам, затем к разделу экспериментов. Тогда к моменту написания вводных и заключительных разделов само собой сложится понимание того, как рассказать о том же самом менее формально.
-
* Если какое-то словосочетание вызывает сомнения, поищите его в Google вместе с возможными вариантами. Часто ли оно употребляется в научных текстах, особенно по Вашей тематике? Не совпадает ли оно с чем-нибудь неподходящим или даже неприличным? Поиск подходящих отрывков фраз в Интернете — это долгий, но верный способ написать хороший текст даже при посредственном владении языком. Как обычно, приходится выбирать — время или качество — что Вам дороже.
+
* Если какое-то словосочетание вызывает сомнения, поищите его в Google вместе с возможными вариантами. Часто ли оно употребляется в научных текстах, особенно по Вашей тематике? Не является ли оно термином в совсем другой области? Не совпадает ли оно с чем-нибудь неподходящим или даже неприличным? Поиск подходящих отрывков фраз в Интернете — это долгий, но верный способ написать хороший текст даже при посредственном владении языком. Как обычно, приходится искать компромисс между временем и качеством.
== См. также ==
== См. также ==
* [[Научно-исследовательская работа (рекомендации)]]
* [[Научно-исследовательская работа (рекомендации)]]
 +
* [[Учебная литература по анализу данных и машинному обучению (рекомендации)]]
* [[Подготовка презентаций (рекомендации)]]
* [[Подготовка презентаций (рекомендации)]]
* [[Защита выпускной квалификационной работы (рекомендации)]]
* [[Защита выпускной квалификационной работы (рекомендации)]]
Строка 327: Строка 408:
== Ссылки ==
== Ссылки ==
* [http://crec.mipt.ru/base/diplomas/guides Руководства по написанию научных работ] — материалы кафедры вычислительной математики МФТИ.
* [http://crec.mipt.ru/base/diplomas/guides Руководства по написанию научных работ] — материалы кафедры вычислительной математики МФТИ.
-
* [http://www.ccas.ru/voron/forstudents.html Студентам о научно-исследовательской работе] — старая версия данной страницы.
+
* [http://theoryandpractice.ru/posts/3262-chelovek-ochen-umnyy-on-vse-ponimaet-tolko-skazat-ne-mozhet Человек очень умный: он все понимает, но сказать не может] — колонка Игоря Гладкобородова «Технологии и медиа глазами программиста» на сайте TheoryAndPractice.ru.
 +
* [http://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%BC%D0%B5%D0%BD%D1%81%D0%BA%D0%B8%D0%B9,_%D0%AF%D0%BD_%D0%90%D0%BC%D0%BE%D1%81 Коменский, Ян Амос] (17-й век) -- основоположник научной педагогики, изобретатель классно-урочной системы.
 +
* [http://www.ccas.ru/voron/forstudents.html Студентам о научно-исследовательской работе] — старая версия данной страницы.
 +
* [http://www.scottaaronson.com/blog/?p=304 Ten Signs a Claimed Mathematical Breakthrough is Wrong] — The Blog of Scott Aaronson
== Литература ==
== Литература ==

Текущая версия

Содержание

Приведённые ниже рекомендации по подготовке статей, отчётов, квалификационных работ адресованы, главным образом, студентам и аспирантам.

Введение

Во всем мире научные статьи пишут по определенным канонам, выработанным многими поколениями учёных. Традиции в данном случае необходимы для того, чтобы разные люди без дополнительных усилий понимали друг друга. Чем жёстче требования к терминологии, языку, форме подаче материала, оформлению, тем меньше читатель отвлекается на второстепенные детали, тем быстрее он сможет понять основную суть работы. Пренебрегать этими традициями — значит быть неадекватным в глазах сообщества.

Всякая научная статья преследует одновременно две цели:

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

О том, как писать научные статьи именно в области машинного обучения, здорово рассказано в заметке Пэта Лэнгли Crafting Papers on Machine Learning. К отчетам, курсовым и выпускным работам изложенные там соображения тоже относятся в полной мере.

С чего начать

Допустим, вы решили задачу — построили модель, доказали теорему, сделали вычислительный эксперимент, получили результаты. С чего начать писать отчёт, как преодолеть барьер вхождения?

  • Сформулируйте и запишите цели вашего исследования. Вам наверняка придётся использовать специальные термины, которые Ваш приятель-однокурсник не знает. Допустим, Вы объясняете ему Вашу работу, пока идёте вместе от университета до ближайшего транспорта. Бумаги и ручки нет, доски нет, презентации нет, можно только говорить. Объясните ключевые понятия, расскажите, откуда взялась задача, и в чём состояла проблема. Вот Вы и написали введение.
  • Запишите структурный план всей статьи, со всеми разделам и подразделами.
  • Начните писать тот раздел, который Вам кажется наиболее простым и ясным. Обычно это раздел понятий и обозначений.
  • Вот Вы и разогнались. Далее дело пойдёт само. Дописывайте разделы в том порядке, к которому у Вас лежит душа. Научная статья — это не детектив, её не обязательно писать подряд.
  • Каждый раз, когда дело застопоривается, консультируйтесь с научным руководителем.

Типичная структура научной статьи

Чтобы научиться писать научные статьи, надо понять, как люди их читают. Оказывается, большинство учёных читают аннотацию, заключение и (прямо как дети) смотрят картинки, пытаясь быстро сделать какие-то выводы из графиков и подписей под ними. Только если статья кажется стоящей, чтобы потратить на неё время, её начинают читать. Но большинство всё равно не читают дальше введения.

Отсюда важные практические выводы:

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

Аннотация

Краткое описание темы исследования и основного результата, одним абзацем на 5–15 строк, без формул, без ссылок на литературу, без узкоспециальных терминов.

Цель аннотации: обозначить в общих чертах, о чем работа. Прочитав аннотацию в течение минуты, не-специалист в данной узкой теме должен понять, интересна ли ему эта работа, и стоит ли читать дальше.

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

Введение

Во введении рассказывается, где возникает данная задача, и почему ее решение так важно. Вводится на неформальном уровне минимум терминов, необходимый для понимания постановки задачи. Приводится краткий анализ источников информации (литературный обзор): как эту задачу решали до сих пор, в чем недостаток этих решений, и что нового предлагает автор. Формулируются цели исследования. В конце введения даётся краткое содержание работы по разделам; при этом отмечается, какие подходы, методы, алгоритмы предлагаются автором впервые. При упоминании ключевых разделов кратко формулируются основные результаты и наиболее важные выводы.

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

Введение лучше писать напоследок, так как в ходе работы обычно происходит переосмысление постановки задачи. Если же введение писать, когда работа еще не готова, задача усложняется вдвойне. В конце обычно приходит понимание, что всё получилось совсем не так, как планировалось в начале, и исходный вариант введения всё равно придётся переписывать. Кстати, к таким «потерям» надо относиться спокойно — в хорошей работе почти каждый абзац многократно переделывается до неузнаваемости.

Определения и обозначения

Формальная постановка задачи. Для известных понятий желательно придерживаться стандартных обозначений. Общепринятые термины вводятся словом «называется». Термины, придуманные самим автором, вводятся словами «назовём» или «будем называть». Обычно этот раздел заканчивается формальной постановкой задачи.

Именно с этого раздела стоит начинать писать статью.

Известные результаты

Перечисляются подходы, методы, факты, на которые существенно опирается данная работа, но которые могут быть не известны широкому кругу читателей. Здесь ссылки на литературу обязательны. Теоремы только формулируются, но не доказываются.

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

Как понять, какие обозначения надо вводить, и какие известные результаты упоминать, особенно, если это первая в жизни научная статья?

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

Новые подходы и результаты

Один или несколько разделов — основные результаты, полученные автором. Собственно, ради их опубликования и пишется весь текст. Теоремы приводятся с доказательствами.

Вычислительный эксперимент

Описывается прикладная задача, параметры анализируемых данных (например, сколько объектов, сколько признаков, и каких они типов), параметры эксперимента (например, как производился скользящий контроль). Результаты экспериментов представляются в виде таблиц и графиков. Объясняется точный смысл всех обозначений на графиках, строк и столбцов в таблицах. Приводятся выводы: в какой степени результаты экспериментов согласуются с теорией? Достигнут ли желаемый результат? Обнаружены ли какие-либо факты, не нашедшие объяснения, и которые нельзя списать на «грязный» эксперимент?

Цель данного раздела: продемонстрировать, что предложенная теория работает на практике; показать границы её применимости; рассказать о новых экспериментальных фактах. Чисто теоретические работы могут не содержать данного раздела (не работает, ну и не надо — зато теория красивая). Кстати, теоретики имеют право не догадываться, где, кому и когда их теории пригодятся.

Обсуждения и выводы

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

Заключение или основные результаты

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

  • Предложен новый подход к…
  • Разработан новый метод…, позволяющий…
  • Доказан ряд теорем, подтверждающих (опровергающих), что…
  • Экспериментально показано, что…

Цель данного раздела: доказать квалификацию автора. Даже беглого взгляда на заключение должно быть достаточно, чтобы стало ясно: автору удалось решить актуальную, трудную, ранее не решённую задачу, предложенные автором решения обоснованы и проверены.

Кстати, в отзывах и рецензиях это выражается примерно такими словами: «работа удовлетворяет всем требованиям, предъявляемым к [бакалаврским, магистерским, дипломным, кандидатским — ненужное вычеркнуть] диссертациям; автор достоин присуждения ему звания [бакалавра, магистра, и т.д.]».

Благодарности

Ссылки на гранты; реже — благодарности коллегам, подсказавшим важные идеи.

Литература

Дурным тоном считается:

  • ссылаться на работы только одного-двух авторов (например, себя или шефа);
  • ссылаться на слишком малое число работ;
  • ссылаться только на очень старые работы;
  • ссылаться на работы, которых автор ни разу не видел;
  • вообще ни на что не ссылаться.

Что совсем не принято

В англоязычных квалификационных работах, где-то в начале, иногда встречаются посвящения типа «моим дорогим родителям и сестрёнке», «дедушке с бабушкой», «любимой жене, попугаю, двум собакам и трём котам за то, что не слишком мешали», ну, и так далее... В нашей национальной традиции за такие фортели подвергают остракизму. Вот вырастете большим, будете писать большую толстую книгу, и там себе позволяйте что угодно или что редактор разрешит.

Десять принципов ясного изложения

Чтобы научиться самому хорошо писать научные тексты, надо постоянно читать чужие научные тексты. При этом задумываться над такими вопросами: Всё ли мне действительно понятно? Если что-то не понятно, то почему — моих знаний не хватает или написано плохо? Если написано плохо, то что именно, и что должен был бы сделать автор, чтобы я его понял. При таком вдумчивом чтении Вы скоро выработаете свои приёмы ясного изложения.

Прямой путь — самый короткий

Всегда используйте минимальный набор средств (понятий, обозначений, пояснений), достаточный, чтобы Вас поняли. Не правда ли, красивые общие слова, но совершенно неконкретные... Как же воспользоваться этой рекомендацией на практике? Одна из возможных технологий такая:

Подумайте, какую основную мысль Вы собираетесь донести до читателя. Не начинайте издалека, именно её сразу и напишите. Теперь подумайте, почему Вас могут не понять, если сходу прямо так и сказать. Ваш коллега, вместе с которым Вы делали эту работу, наверное, поймёт. А вот незнакомому читателю надо сперва объяснить все использованные Вами понятия, сформулировать проблему, объяснить, зачем её надо решать, и т.д. Всё это придётся написать перед основной мыслью.

Главное — не «ходить вокруг да около» и не писать лишнего! Пишите только то, без чего основную мысль объяснить невозможно.

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

Старайтесь дойти до раскрытия основной мысли кратчайшим путём. Как будет найден этот путь — от конца к началу, от начала к концу или с середины — в конечном итоге не так уж важно, это дело вкуса.

Наблюдение. Многие студенты поначалу думают, что надо писать витиевато и наукообразно. На самом деле это не придаёт тексту солидности, как раз наоборот — вызывает подозрение, что работа является «пустышкой», формой без содержания. Из таких текстов можно без ущерба для смысла выбрасывать целые абзацы, фразы, отдельные слова.

Чаще перечитывайте текст и проверяйте каждую фразу: можно ли её выкинуть? Является ли такой ход изложения кратчайшим? Тут полезно быть жадным, но только в том смысле, чтобы побольше выкинуть, а не побольше написать.

Время читателя — ценнейший ресурс

Эталоном неясного изложения будем считать «казённый язык» — сухой, скучный, трудно понимаемый, но при этом формально абсолютно корректный (бесспорно, существуют образцы ещё более ужасного изложения; однако здесь обсуждается проблема, как из хорошего сделать лучшее).

Наблюдение. «Казённым» стилем обычно пишутся законы, руководства и инструкции. В советские времена в таком стиле писали газеты (хочешь понять — читай между строк). Таким стилем все ещё пишут некоторые провинциальные ученые… Но это неправильно.

Автор должен стремиться экономить время читателей хотя бы потому, что он один, а читателей много. Сегодня никто не хочет тратить своё время на чтение между строк и выискивание крупиц смысла в пустых витиеватых фразах. Время дороже денег. Если статью не удаётся понять быстро, она будет отложена навсегда.

Краткость — сестра таланта

Фразы должны быть короткими. В каждой фразе должна быть ровно одна мысль. В русской фразе (кстати, как и в английской) самое важное слово, значимость которого хочется подчеркнуть особо, ставится последним. Обратите внимание на положение слов «особо» и «последним» в предыдущей фразе. Теперь ясно, что имеется в виду?

Наблюдение: в «казенных» текстах фразы длинные, содержат по несколько мыслей, и наиболее значимое слово прячется в середине.

Не надо пытаться сказать одну мысль несколькими разными способами. Нужно оставить только один, самый лучший, способ.

Наблюдение: в гуманитарных текстах (например, в Библии) делается наоборот — одна и та же мысль повторяется многократно, но в разных формах. Чтобы каждый смог осознать её в той форме, которая лично ему ближе.

В техническом тексте нет необходимости украшать содержание разнообразием форм, так как его цель — передача знания, а не ощущения.

Комментирование формул

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

Наблюдение. Математики делятся на две категории. «Алгебраисты» быстро понимают и хорошо запоминают формулы. «Геометры» предпочитают понимать содержательный смысл высказываний. Алгебраисты более формальны, геометры — более интуитивны. Первые быстрее воспринимают язык формул, вторые предпочитают воспринимать идеи, вникая в технические подробности только в случае необходимости.

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

Простота и постоянство обозначений

Система обозначений должна быть проста (не перегружена) и не меняться по ходу изложения.

Наблюдение. Трудно читать статью, в которой постоянно повторяются одни и те же сложные (состоящие из многих символов) агрегаты. Почему? Читатель тратит время и мыслительные усилия на постоянное сравнение того агрегата, который он видит сейчас, с теми, которые встречались на предыдущих старницах. То есть зашифровывать математический текст всегда проще, чем расшифровывать. Не обманывайте себя этой простотой и пожалейте своих читателей.

Отсюда вывод: если агрегат встречается более двух раз, возможно, для него стоит ввести вспомогательную букву и как-то назвать его словами. Человеку привычнее и приятнее запоминать и сравнивать имена, чем многоэтажные формулы.

Наблюдение. Всегда можно найти способ избежать тройных индексов, например, ввести вспомогательное подмножество.

В английском алфавите достаточно букв, чтобы приписать им фиксированные роли. Например, если договорились, что x_i — это i-й объект, то лучше не использовать букву x и индекс i для чего-либо, кроме объектов. Тогда читатель быстро привыкает к обозначениям основных понятий, и уже не будет отвлекаться на то, чтобы вернуться выше и разобраться, в данном случае i глобален (тот самый, что был использован при введении обозначений в самом начале), или он снова в десятый раз поменял смысл.

Наблюдение. Лучший способ заставить человека потратить на изучение отчёта втрое больше времени — всё время менять обозначения, а индексы и аргументы функций вводить «ненадолго» и ниже произвольным образом менять их смысл. Тогда читатель будет тратить основное время на то, чтобы понять, что есть что, и легко пропустит десяток действительно серьёзных ляпов. Автор должен быть готов к тому, что читатель расценит такой текст как оскорбление или попытку сознательного сокрытия истинного положения дел.

Баланс формального и неформального

Формальное изложение (гипотезы, определения, леммы, теоремы, следствия, замечания) должно перемежаться неформальными пояснениями, интерпретациями, замечаниями, примерами, апеллирующими к интуиции и здравому смыслу. Однако оформляться это должно так, чтобы читатель сразу понял: «вот тут закончились доказательства и начались интерпретации». В англоязычных статьях в этом месте принято вставлять раздел Discussion (обсуждение).

Наблюдение. Эпоха чисто формальных текстов в прикладной математике уходит в прошлое. Их приходится не читать, а буквально расшифровывать, что влечёт неоправданные затраты времени. С другой стороны, нестрогое изложение чревато тем, что читатель просто не поймёт, что же в точности хотел сказать автор. Да и автору легко поддаться искушению и красиво расписать какую-нибудь сырую идею, которая на поверку окажется неработоспособной.

Золотая середина — это дозированное сочетание математически строгого изложения и неформальных пояснений, которые подкрепляют друг друга.

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

Структуризация

Изложение основной части должно быть структурировано, то есть разбито на блоки (параграфы, разделы). Каждый блок должен решать более-менее обособленную задачу. В начале блока должно быть объявлено, зачем она решается, и почему она решается именно так. Чтобы ответить на вопрос «зачем», надо вспомнить общую цель всего исследования. Чтобы ответить на вопрос «почему так», надо сделать обзор литературы.

Наблюдение. В маргинальных исследованиях вопросы «зачем» и «почему так» либо не ставятся, либо на них даются невнятные (неконкретные, слишком философские) ответы. Это может означать, что автор считает себя умнее мирового научного сообщества или просто поленился изучить предыдущий опыт, и теперь изобретает велосипед. Такие работы, как правило, неадекватны и только засоряют мозг.

Каждый раздел, независимо от уровня и объема, строится по одному и тому же сценарию. В начале неформально объясняется постановка задачи и её роль во всем исследовании (или в объемлющем разделе). В заключении неформально объясняется, что получилось, и как это интерпретировать. Если в следующих разделах полученный результат будет улучшен, об этом стоит упомянуть. Средняя часть может быть целиком формальной.

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

Логичная последовательность изложения

Каждая следующая фраза должна логично вытекать непосредственно из предыдущей (или нескольких предыдущих). Слишком жёстко? Тогда хотя бы 95% фраз. Следить за линейной логикой изложения на порядок менее утомительно, чем за перескоками с темы на тему. Резкая смена темы должна оформляться в явном виде как новый параграф, раздел, подраздел.

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

Наблюдение. В учебниках и хороших книгах таких грубых ошибок не бывает — благодаря тому, что эти тексты десятки раз вычитываются авторами, рецензентами и редакторами.

Точность передачи смысла

Это, наверное, самое сложное. От автора требуется хорошее владение как техническим, так и литературным языком.

Наблюдение: хорошо садиться писать статью, начитавшись хорошей специальной или художественной литературы.

От автора также требуется изрядная изобретательность. Автор имеет полную свободу выбора — какие понятия и определения ввести, чтобы дальнейшее изложение было максимально удобным и понятным.

Наблюдение: презентабельность основного результата может сильно зависеть от того, какими словами о нём рассказывают. Если суть результата не удаётся донести парой фраз, это, возможно, признак того, что стоило бы ввести несколько новых понятий. То есть придать нескольким хорошо известным русским словам новый, Ваш собственный, узко специальный, смысл. Разумеется, удачный выбор таких слов — это искусство.

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

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

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

Наблюдение: «казенные» тексты напичканы абстрактными глаголами.

Семь раз прочти, один раз отправь

На самом деле семь раз — это мало. Обычно студент, пишущий свою первую курсовую или статью, не отдаёт себе отчёта в том, сколько ляпов будет сделано по невнимательности. Почти в каждой фразе! Это нормально, людям свойственно ошибаться. Ещё многим людям свойственно не замечать собственных ошибок. Поэтому стадию внимательного вычитывания ни в коем случае пропускать нельзя.

Рекомендация: в конце работы над статьёй запланируйте посвятить целый день многократному внимательному прочтению своего труда. Где-то будут пропущены формулы или целые фразы. Это не пустяк! Поставьте себя на место незнакомого читателя и осознайте факт: научный текст легко может оказаться целиком непонятным из-за одной единственной ошибки. Где-то можно перестроить фразу и сказать получше. Или покороче. Где-то можно упростить обозначения или вообще избавиться от лишних закорючек. Иногда чисто формальное упрощение неожиданно подсказывает идею более изящного доказательства. К вечеру Ваш текст начнёт Вам нравиться, и Вы поймёте, что день прожит не зря. Не лишайте себя этого кайфа!

Перфонтана

Опыт преподавания и научного руководства показывает, что среди студентов находятся любые крайности. Есть студенты с врождённым чувством качества русского текста, которые в первый же раз приносят вполне «гладко написанную» работу. Другая крайность — когда в тексте нет логических связок между предложениями, количество неточностей и опечаток огромно, всё что можно было перепутать, перепутано, и буквально всё надо переделывать. Возможно, человек просто торопился и ни разу не прочитал то, что написал. Но иногда оказывается, что внутренние критерии качества написанного текста у человека просто отсутствуют. Это не фатум — дело наживное. Но и психологическая встряска в таком случае не повредит ;) Потратьте 15 минут времени и посмотрите на Перфонтану — как китайские производители детских кубиков, плохо владеющие русским языком, напутали всё, что можно было напутать. Получилось до слёз смешно. Обычно в этот момент студент осознаёт, какие чувства у преподавателя вызывает его работа... и начинает стараться.

Дело ТеХники

Для оформления научных статей, отчётов, квалификационных работ, учебных курсов, книг рекомендуется освоить систему компьютерной вёрстки LaTeX.

  • Памятка по установке и использованию MiKTeX и WinEdt.
  • LaTeX в примерах (pdf) — сборник примеров, помогающий довольно быстро освоить LaTeX в объеме, достаточном для написания первой статьи.

Статья на английском

Это отдельная большая тема для разговора, а краткие рекомендации такие.

  • Перед написанием собственного текста обязательно прочтите несколько канонических обзоров по Вашей теме, чтобы «пропитаться» правильными терминами, мотивациями, оборотами речи, конструкциями английских фраз — они не такие, как в русском языке!
  • Обязательно прочтите книги Сосинского или Кутателадзе (а лучше обе), даже если Вы считаете, что хорошо знаете язык. Первая даёт простую методику, которая позволит сразу приступить к делу; вторая книга глубже и потребует более тщательного изучения. Если совсем кратко, основные рекомендации таковы:
    • не переводите текст с русского на английский, а рассказывайте содержание вашей работы по-английски;
    • в каждой фразе придерживайтесь жёсткого порядка: подлежащее → сказуемое → дополнение;
    • не стройте слишком сложных и длинных предложений;
    • используйте математические клише, которые даются в этих двух книгах;
  • Введение, обзор и другие разделы, где больше всего «человеческой речи», пишите в последнюю очередь. Начинать проще всего с раздела определений и обозначений, затем переходить к формальным математическим результатам, затем к разделу экспериментов. Тогда к моменту написания вводных и заключительных разделов само собой сложится понимание того, как рассказать о том же самом менее формально.
  • Если какое-то словосочетание вызывает сомнения, поищите его в Google вместе с возможными вариантами. Часто ли оно употребляется в научных текстах, особенно по Вашей тематике? Не является ли оно термином в совсем другой области? Не совпадает ли оно с чем-нибудь неподходящим или даже неприличным? Поиск подходящих отрывков фраз в Интернете — это долгий, но верный способ написать хороший текст даже при посредственном владении языком. Как обычно, приходится искать компромисс между временем и качеством.

См. также

Ссылки

Литература

  • Pat Langley. Crafting Papers on Machine Learning. ICML 2001.
  • А. Б. Сосинский. Как написать математическую статью по-английски. — М.: Изд-во «Факториал Пресс», 2000. — 112 с. ISBN 5-88688-032-1.
  • С. С. Кутателадзе. Russian→English in Writing. Советы эпизодическому переводчику. Изд. 7-е, исправл. и допол. — Новосибирск: Институт математики им. С.Л.Соболева Сибирского отделения РАН, 2007. — 196 с.
Личные инструменты