Виноски, посилання та додатки: хто що робить

Куди належать сторони, докази та додаткові матеріали, і хто насправді їх читає.

Виноски, посилання та додатки: хто що робить

Папір має три місця для розміщення матеріалу, який не належить до основного потоку, і кожне має окрему роботу. Розмістіть потрібний вміст у потрібному місці, і читачі залишатимуться орієнтованими. Змішайте їх, і ваша газета буде читатися як ящик для сміття.

Виноски: ввічливість убік

Виноска — це те, що варто сказати, але не варто переривати речення: 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» жодного разу не пом’якшила рецензію. Помістіть свій найкращий матеріал там, де його знайде знежирене, і дозвольте зворотній частині робити те, що вона вміє найкраще: спокійно тримати квитанції.

Назад до Анатомія паперу