Сноски, список литературы и приложения: кто за что отвечает

Где место замечаниям, доказательствам и материалам, которые не поместились в основной текст, и кто их на самом деле читает.

Сноски, список литературы и приложения: кто за что отвечает

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

Сноски: вежливое отступление

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

We use the standard split.\footnote{Available at
\url{https://example.org/data}.}

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

Список литературы: цепочка доказательств

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

В LaTeX механика автоматическая: \cite{key} в тексте, запись в файле .bib, и список строится сам.

Transformers \cite{vaswani2017attention} replaced recurrence
with attention.

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

Приложение: место для всего, что не поместилось

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

\appendix
\section{Full proofs}

После \appendix разделы сами получают буквенные номера A, B, C.

Дополнительные материалы: за пределами PDF

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

Кто что на самом деле читает

ЧастьКак ведёт себя рецензент
СноскиЧитает мимоходом, быстро забывает
Список литературыПросматривает в поисках недостающих работ, особенно своих
ПриложениеОткрывает, когда нужно проверить утверждение из статьи
Дополнительные материалыОткрывает тот единственный рецензент, который запускает ваш код

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

Вернуться к Анатомия статьи