Another attempt at docstrings for names and parameters--using "||"

[pawamoy (Timothée Mazzucotelli)]

@jamestwebber

Personally I wouldn’t write multi-line descriptions in the signature, because I think it’s hard to read, and I certainly wouldn’t put a block of text related to the return value there.

So where would you write these multi-line descriptions when you need them? I find the return block weirdly placed too, but can’t think of a better alternative.

I’ll try to see if I can reach out to docments authors and bring them here