add notes to publish() doc