this belongs in the `_extract` docstring?