Since you're in there anyway... we want to move to `numpy`-style docstrings, which means each function should have a single-line description standing alone at the top. So in other words, just put two newlines in after the end of the first sentence `by name.`