Better round tripping for See also section

[hmaarrfk]

Potential Fix for #188

[pv]

-1, they are meant to become links, and this breaks SphinxDocString behavior.

I'm not exactly sure if what you are trying to achieve aligns with numpydoc goals.
In particular, round-tripping the docstrings is not a design goal for numpydoc.

[hmaarrfk]

ok

[hmaarrfk]

@pv, could it be provided as an additional function? There has been some interest in having wrapper modify the docstrings:

#67 (comment)

Something I wrote:
https://github.com/hmaarrfk/deprecation_factory/blob/cfe72994e991e9833b7084419d5341139a6da97b/deprecation_factory/default_parameter_change.py#L146

Having the ability to roundtrip docstrings would be useful in these cases.

[pv]

Changes in SphinxDocString.__str__ output generally should make sure the changes in the output do not cause regressions in how the documentation is formatted by Sphinx.

There's more freedom in changing what NumpyDocString.__str__ outputs, as that is not used in the documentation output. If you want to make that to round-trip, that's in principle possible, but note that the implementation is often entangled with SphinxDocString.__str__.