papyrus-latex-comments

LaTeX Comments

Add a visible, attributable, removable layer of NOTES to a LaTeX document — remarks ABOUT the text, never a rewrite of it. Insert a macro call next to the relevant text. See papyrus-writing for the behaviour rules and the comment taxonomy. To propose concrete replacement text (accept/reject), use papyrus-latex-suggestions.

Step 1 — Setup (idempotent)

kpsewhich todonotes.sty    # non-empty = installed (ships with TeX Live — usually no install)

If the document has no comment preamble yet, inject this once at the end of the preamble, after all existing \usepackage lines (never duplicate it if it is already there):

% ==== Papyrus comment layer — safe to leave in; flip to hide ====
% Load todonotes ONLY if the document hasn't already loaded it (avoids an option clash).
\makeatletter
\@ifpackageloaded{todonotes}{}{\usepackage[textsize=scriptsize]{todonotes}}
\makeatother
\newcommand{\aicomment}[1]{\todo[color=cyan!25,bordercolor=cyan]{\textbf{AI:} #1}}   % margin note
% FINAL BUILD: hide every note by adding the `disable` option to todonotes
% (wherever it is loaded): \usepackage[disable]{todonotes}.
% ================================================================

Margin space is tight, so textsize=scriptsize keeps notes readable in a one-column margin. Comments live in the margin only — a note must never change the paper's length or reflow the text. In a two-column or narrow-margin paper, keep each note short rather than pushing it into the text flow.

Step 2 — Insert comments

Add a macro call next to the relevant text. Do NOT rewrite the prose. Tag every note with the taxonomy ([claim] [cite] [clarity] [structure] [contribution] [rigor] [style] [typo]).

The method is fast.\aicomment{[claim] by how much? add a number + CI}
This paragraph reads like Related Work.\aicomment{[structure] consider moving it there}
We imitate the baseline.\aicomment{[clarity] ``imitate'' is imprecise — say exactly what you did to the baseline}