The mode's documentation string was extended in Emacs 26.1, please see
if you find the documentation there sufficient. Otherwise feel free to
provide concrete suggestions for further improvements.

I've updated the docstring to mention fill-paragraph too, which will
be visible in Emacs 26.2.