Виноски, джерела й додатки: хто що робить

Де має стояти відступ, доказ і зайвий матеріал, і хто це справді читає.

Виноски, джерела й додатки: хто що робить

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

Виноски: ввічливий відступ

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

Назад до Анатомія статті