We should define docstrings that get repeated in one place and programmatically add them to all the appropriate methods/functions. This will reduce the maintenance burden of keeping them all in sync and render just as nicely for users. Developers working on the code may have to look at the compiled docs to understand things, but we agreed that was worth the reduced maintenance burden.