Pendantic: I'd name the 'paragraphs' parameter something else. You're taking in paragraph_indices, or paragraph_ids or something like that, not whole paragraphs. I feel like naming is part of the documentation of something.