Can you add a numpydoc `Parameters` listing like we have elsewhere in the code.  This goes for both functions.