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

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

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

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

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

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

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