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

Кроме того, кому принадлежат доказательства и дополнительный материал, и кто на самом деле их читает.

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

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

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

Сноска предназначена для чего-то, что стоит сказать, но не стоит прерывать предложение: 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» ни разу не смягчила рецензию. Поместите свой лучший материал туда, где его найдет обезжиренный, и позвольте бэк-матерю делать то, что он умеет лучше всего: спокойно хранить квитанции.

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