I'm not sure about this. I'd love to generate API docs from docstrings. But even if not, there's still use for these. Docstrings can show up in different development UIs in editors. I think they render this markup too.

CodSpeed Performance Report

Merging #1203 will improve performances by 11.21%

_{Comparing asvetlov:docsting (c3acd3b) with master (2119f97)}

Summary

⚡ 1 improvements
✅ 243 untouched benchmarks

Benchmarks breakdown

Let's either generate documentation from doctrings and start using markups, or drop the markup if we don't use it anywhere except the single place.

Moreover, the existing dosctring is not correct, there is no other argument in the method's signature.

I propose the less invasive change; if somebody wants to work on the library documentation -- I'd love to review the PR.