Тест на привязку
Если мысль теряет смысл без этого фрагмента или версии — это comment. Если она полезна сама по себе — скорее note.
Комментарии сохраняют редакторский контекст
«Проверить эту цифру», «редактор спорит с утверждением», «оставить фразу — она окупится в главе 9», «переписать после интервью» понятны именно потому, что указывают на конкретное место.
Заметки держат более широкое мышление
Исследовательские идеи, возможные темы, будущие главы, ссылки и вопросы ко всей книге могут спокойно жить независимо от одного абзаца.
Почему не писать TODO прямо в рукописи?
На раннем черновике это иногда нормально. Но inline TODO легко забыть и случайно отправить в export. Comment хранит задачу рядом с прозой, но не внутри прозы.
Скриншот: comment vs noteСлева comment к одной фразе и общий комментарий к версии. Справа отдельная project note про исследование или будущую главу.
assets/img/bmaker/bmaker-explained-comment-note-01.webpКомментарий может сохранить не только «что», но и «почему»
История версий показывает, что изменилось. Комментарий способен объяснить, почему странная фраза осталась, что нужно проверить и что имел в виду рецензент.