I would like to stick to the docstring style of a one-line summary, followed by whatever details are needed.