clean up / add docstrings and doctests in all synthetic models

[benwandrew]

we are not consistent about docstrings and doctests in the synthetic models. some include comprehensive ones, some partial, some none. although not mission-critical, we should probably clean these up and enforce standards via PR going forward.

[benwandrew]

moving this to "No Status" per discussion last week -- not necessary for the release we're pushing for